Skip to content

API Docs

This document enumerates the Custom Resource Definitions used by the M3DB Operator. It is auto-generated from code comments.

Table of Contents


ClusterCondition represents various conditions the cluster can be in.

Field Description Scheme Required
type Type of cluster condition. ClusterConditionType false
status Status of the condition (True, False, Unknown). corev1.ConditionStatus false
lastUpdateTime Last time this condition was updated. string false
lastTransitionTime Last time this condition transitioned from one status to another. string false
reason Reason this condition last changed. string false
message Human-friendly message about this condition. string false

Back to TOC


ClusterSpec defines the desired state for a M3 cluster to be converge to.

Field Description Scheme Required
image Image specifies which docker image to use with the cluster string false
replicationFactor ReplicationFactor defines how many replicas int32 false
numberOfShards NumberOfShards defines how many shards in total int32 false
isolationGroups IsolationGroups specifies a map of key-value pairs. Defines which isolation groups to deploy persistent volumes for data nodes []IsolationGroup false
namespaces Namespaces specifies the namespaces this cluster will hold. []Namespace false
etcdEndpoints EtcdEndpoints defines the etcd endpoints to use for service discovery. Must be set if no custom configmap is defined. If set, etcd endpoints will be templated in to the default configmap template. []string false
keepEtcdDataOnDelete KeepEtcdDataOnDelete determines whether the operator will remove cluster metadata (placement + namespaces) in etcd when the cluster is deleted. Unless true, etcd data will be cleared when the cluster is deleted. bool false
enableCarbonIngester EnableCarbonIngester enables the listener port for the carbon ingester bool false
configMapName ConfigMapName specifies the ConfigMap to use for this cluster. If unset a default configmap with template variables for etcd endpoints will be used. See \"Configuring M3DB\" in the docs for more. *string false
podIdentityConfig PodIdentityConfig sets the configuration for pod identity. If unset only pod name and UID will be used. *PodIdentityConfig false
containerResources Resources defines memory / cpu constraints for each container in the cluster. corev1.ResourceRequirements false
dataDirVolumeClaimTemplate DataDirVolumeClaimTemplate is the volume claim template for an M3DB instance's data. It claims PersistentVolumes for cluster storage, volumes are dynamically provisioned by when the StorageClass is defined. *corev1.PersistentVolumeClaim false
podSecurityContext PodSecurityContext allows the user to specify an optional security context for pods. *corev1.PodSecurityContext false
securityContext SecurityContext allows the user to specify a container-level security context. *corev1.SecurityContext false
imagePullSecrets ImagePullSecrets will be added to every pod. []corev1.LocalObjectReference false
labels Labels sets the base labels that will be applied to resources created by the cluster. // TODO(schallert): design doc on labeling scheme. map[string]string false
annotations Annotations sets the base annotations that will be applied to resources created by the cluster. map[string]string false
tolerations Tolerations sets the tolerations that will be applied to all M3DB pods. []corev1.Toleration false
priorityClassName PriorityClassName sets the priority class for all M3DB pods. string false

Back to TOC


IsolationGroup defines the name of zone as well attributes for the zone configuration

Field Description Scheme Required
name Name is the value that will be used in StatefulSet labels, pod labels, and M3DB placement \"isolationGroup\" fields. string true
nodeAffinityTerms NodeAffinityTerms is an array of NodeAffinityTerm requirements, which are ANDed together to indicate what nodes an isolation group can be assigned to. []NodeAffinityTerm false
numInstances NumInstances defines the number of instances. int32 true
storageClassName StorageClassName is the name of the StorageClass to use for this isolation group. This allows ensuring that PVs will be created in the same zone as the pinned statefulset on Kubernetes < 1.12 (when topology aware volume scheduling was introduced). Only has effect if the clusters dataDirVolumeClaimTemplate is non-nil. If set, the volume claim template will have its storageClassName field overridden per-isolationgroup. If unset the storageClassName of the volumeClaimTemplate will be used. string false

Back to TOC


M3DBCluster defines the cluster

Field Description Scheme Required
metadata metav1.ObjectMeta false
type string true
spec ClusterSpec true
status M3DBStatus false

Back to TOC


M3DBClusterList represents a list of M3DB Clusters

Field Description Scheme Required
metadata metav1.ListMeta false
items []M3DBCluster true

Back to TOC


M3DBStatus contains the current state the M3DB cluster along with a human readable message

Field Description Scheme Required
state State is a enum of green, yellow, and red denoting the health of the cluster M3DBState false
conditions Various conditions about the cluster. []ClusterCondition false
message Message is a human readable message indicating why the cluster is in it's current state string false
observedGeneration ObservedGeneration is the last generation of the cluster the controller observed. Kubernetes will automatically increment metadata.Generation every time the cluster spec is changed. int64 false

Back to TOC


NodeAffinityTerm represents a node label and a set of label values, any of which can be matched to assign a pod to a node.

Field Description Scheme Required
key Key is the label of the node. string true
values Values is an array of values, any of which a node can have for a pod to be assigned to it. []string true

Back to TOC


IndexOptions defines parameters for indexing.

Field Description Scheme Required
enabled Enabled controls whether metric indexing is enabled. bool false
blockSize BlockSize controls the index block size. string false

Back to TOC


Namespace defines an M3DB namespace or points to a preset M3DB namespace.

Field Description Scheme Required
name Name is the namespace name. string false
preset Preset indicates preset namespace options. string false
options Options points to optional custom namespace configuration. *NamespaceOptions false

Back to TOC


NamespaceOptions defines parameters for an M3DB namespace. See for more details.

Field Description Scheme Required
bootstrapEnabled BootstrapEnabled control if bootstrapping is enabled. bool false
flushEnabled FlushEnabled controls whether flushing is enabled. bool false
writesToCommitLog WritesToCommitLog controls whether commit log writes are enabled. bool false
cleanupEnabled CleanupEnabled controls whether cleanups are enabled. bool false
repairEnabled RepairEnabled controls whether repairs are enabled. bool false
snapshotEnabled SnapshotEnabled controls whether snapshotting is enabled. bool false
retentionOptions RetentionOptions sets the retention parameters. RetentionOptions false
indexOptions IndexOptions sets the indexing parameters. IndexOptions false

Back to TOC


RetentionOptions defines parameters for data retention.

Field Description Scheme Required
retentionPeriod RetentionPeriod controls how long data for the namespace is retained. string false
blockSize BlockSize controls the block size for the namespace. string false
bufferFuture BufferFuture controls how far in the future metrics can be written. string false
bufferPast BufferPast controls how far in the past metrics can be written. string false
blockDataExpiry BlockDataExpiry controls the block expiry. bool false
blockDataExpiryAfterNotAccessPeriod BlockDataExpiry controls the not after access period for expiration. string false

Back to TOC


PodIdentity contains all the fields that may be used to identify a pod's identity in the M3DB placement. Any non-empty fields will be used to identity uniqueness of a pod for the purpose of M3DB replace operations.

Field Description Scheme Required
name string false
uid string false
nodeName string false
nodeExternalID string false
nodeProviderID string false

Back to TOC


PodIdentityConfig contains cluster-level configuration for deriving pod identity.

Field Description Scheme Required
sources Sources enumerates the sources from which to derive pod identity. Note that a pod's name will always be used. If empty, defaults to pod name and UID. []PodIdentitySource true

Back to TOC