Migration to Flex Clusters
Important
Migration to Flex Clusters
Atlas deprecated
M2andM5clusters and Serverless instances. Atlas will automatically migrate allM2andM5clusters to Flex clusters. For Serverless instances, Atlas will determine whether to migrate instances to Free clusters, Flex clusters, or Dedicated clusters according to your usage, then migrate your Serverless instances automatically. To see which tiers Atlas will migrate your instances to, consult the All Clusters page in the Atlas UI. To learn more, see the Flex Migration Guide in the Atlas documentation.Replace references to spec.serverlessSpec with configuration for spec.flexSpec.
Atlas Kubernetes Operator rejects new
AtlasDeploymentcustom resources that define spec.serverlessSpec. You can only usespec.serverlessSpecto manage existing Serverless instances.
Breaking Changes with Atlas Kubernetes Operator 2.0
Important
Action Required for Breaking Changes with Atlas Kubernetes Operator 2.0
With Atlas Kubernetes Operator 2.0,
deploymentSpecreplacesadvancedDeploymentSpecin theAtlasDeploymentcustom resource. You must update yourAtlasDeploymentcustom resource as follows:If you use
advancedDeploymentSpec, rename it todeploymentSpec. You don't need to change any formatting.If you used
deploymentSpecprior to Atlas Kubernetes Operator 2.0, rewrite yourAtlasDeploymentcustom resource to match the formatting used in the examples.
Atlas Kubernetes Operator uses custom resource configuration files to manage your Atlas configuration. As of Atlas Kubernetes Operator 2.0, custom resources you delete in Kubernetes are no longer deleted in Atlas. Instead, Atlas Kubernetes Operator simply stops managing those resources. For example, if you delete an
AtlasProjectCustom Resource in Kubernetes, Atlas Kubernetes Operator no longer automatically deletes the corresponding project from Atlas, preventing accidental or unexpected deletions. To learn more, including how to revert this behavior to the default used prior to Atlas Kubernetes Operator 2.0, see New Default: Deletion Protection in Atlas Kubernetes Operator 2.0.
About the AtlasDeployment Custom Resource
The AtlasDeployment custom resource configures your MongoDB cluster
or Flex cluster in Atlas. When you create the AtlasDeployment
custom resource, Atlas Kubernetes Operator tries to create or update a cluster or
Flex cluster in Atlas.
Atlas Kubernetes Operator does one of the following actions depending on the values you
specify in the AtlasDeployment custom resource:
If you specify values for fields under spec.deploymentSpec, Atlas Kubernetes Operator uses the Atlas Clusters API Resource to create a new cluster or update an existing cluster.
If you specify values for fields under spec.flexSpec, Atlas Kubernetes Operator uses the Atlas Flex Instance API Resource to create a new Flex cluster or update an existing Flex cluster.
Note
Don't specify values for fields under spec.serverlessSpec because Serverless instances are deprecated. Instead, specify fields under spec.flexSpec. To learn more, see Migration to Flex Clusters.
Creating a free tier Atlas cluster takes less than 15 seconds.
Creating or updating a Flex cluster or Dedicated cluster can take up to 10 minutes. Atlas Kubernetes Operator monitors the update process.
You can run the following command to check on the status:
kubectl get atlasdeployment -o yaml
The following example shows the status section of a cluster that is provisioning:
status: conditions: - lastTransitionTime: "2024-03-18T16:32:43Z" status: "False" type: ClusterReady reason: ClusterCreating message: Cluster is provisioning
The ClusterReady status will change to True when the cluster
or Serverless instance is ready.
Examples
Status Example
The following example shows the AtlasDeployment resource with a
ClusterReady status of True:
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: my-atlas-cluster namespace: mongodb-atlas-system spec: projectRef: name: my-project deploymentSpec: name: test-cluster tags: - key: "environment" value: "production" replicationSpecs: - zoneName: US-Zone numShards: 3 regionConfigs: - regionName: CENTRAL_US providerName: GCP backingProviderName: GCP priority: 7 electableSpecs: instanceSize: M10 nodeCount: 3 status: conditions: - lastTransitionTime: "2024-03-18T16:32:43Z" status: "True" type: Ready - lastTransitionTime: "2024-03-18T16:32:43Z" status: "True" type: ClusterReady connectionStrings: standard: mongodb://test-cluster-shard-00-00.kpc8f.mongodb.net:27017,test-cluster-shard-00-01.kpc8f.mongodb.net:27017,test-cluster-shard-00-02.kpc8f.mongodb.net:27017/?ssl=true&authSource=admin&replicaSet=atlas-1gm1pv-shard-0 standardSrv: mongodb+srv://test-cluster.kpc8f.mongodb.net mongoDBVersion: 6.0 mongoURIUpdated: "2024-03-12T12:21:41Z" observedGeneration: 1 stateName: IDLE
Configuration Example
The following example shows an AtlasDeployment custom resource
specification configured for auto-scaling multi-region clusters:
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: test-cluster-name namespace: mongodb-atlas-system spec: projectRef: name: development deploymentSpec: clusterType: REPLICASET name: service-name tags: - key: "environment" value: "production" backupEnabled: true replicationSpecs: - numShards: 1 regionConfigs: - regionName: EASTERN_US providerName: GCP autoScaling: diskGB: enabled: true compute: enabled: true scaleDownEnabled: true minInstanceSize: M30 maxInstanceSize: M40 analyticsSpecs: instanceSize: M30 nodeCount: 1 electableSpecs: instanceSize: M30 nodeCount: 3 priority: 7 readOnlySpecs: instanceSize: M30 nodeCount: 1
Additional Options Example
The following example shows an AtlasDeployment custom resource
specification configured with some of the additional options.
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: my-atlas-cluster spec: projectRef: name: my-project deploymentSpec: name: test-cluster tags: - key: "environment" value: "production" replicationSpecs: - zoneName: Zone 1 regionConfigs: - electableSpecs: instanceSize: M10 nodeCount: 3 providerName: AWS regionName: US_EAST_1 priority: 7 processArgs: javascriptEnabled: false
Flex Cluster Example
Notes on Transition To Flex Clusters
Until January 2026, to preserve backwards compatibility for a period of time, Atlas allows you to manage migrated clusters through both the Serverless instances and Flex clusters APIs, including when you're using Atlas Kubernetes Operator.
You can create and manage Flex clusters in the same AtlasDeployment in which you created and managed Serverless instances and
M2andM5clusters.You can't create NEW
M2/M5clusters and Serverless instances in Atlas. Attempting to do so creates a Flex cluster instead.You can still use existing Serverless instances in Atlas Kubernetes Operator even though existing Serverless instances are deprecated as of early February 2025.
For your existing Serverless instances, you can choose to replace references to spec.serverlessSpec in the AtlasDeployment with the configuration for spec.flexSpec. Or, you can continue using the same spec. Managing a deployment via the
spec.serverlessSpecin theAtlasDeploymentCustom Resource will continue to work even once Atlas automatically migrates these existing clusters to Flex clusters in March 2025.For your existing
M2andM5clusters, you can choose to replace references to spec.deploymentSpec in theAtlasDeploymentCustom Resource with the configuration for spec.flexSpec. Or, you can continue using the same spec. Managing a deployment via thespec.deploymentSpecin theAtlasDeploymentCustom Resource will continue to work even once Atlas automatically migrates these existingM2andM5clusters to Flex clusters in May 2025.For your existing Serverless instances, if you receive errors during reconciliations related to private endpoints, you must upgrade to Atlas Kubernetes Operator 2.7.1, or replace the
serverlessSpecconfiguration with the configuration forflexSpecin theAtlasDeploymentcustom resource.For your
M2andM5clusters, to avoid reconciliation errors that you might notice after the automigration, make the following changes to your CRD configurations:Remove the spec.deploymentSpec.replicationSpecs.zoneName setting.
Remove any of the spec.deploymentSpec.replicationSpecs.regionConfigs settings after the first set of settings.
Specify
replicasetonly in the spec.deploymentSpec.clusterType.
Alternatively, replace references to
spec.deploymentSpecin the AtlasDeployment with the configuration forspec.flexSpec.By January 2026, you must remove all remaining
M2/M5and Serverless Instance configurations from your Atlas Kubernetes Operator custom resources because backwards compatibility of APIs ends January 2026, when the old APIs will be removed and only APIs related to Flex clusters will remain in place.Newer releases of Atlas Kubernetes Operator will cease supporting existing
M2/M5clusters and Serverless instances. Older versions of Atlas Kubernetes Operator will continue to support these instance types until January 2026.
To learn more, see Migration to Flex Clusters in this guide and the Flex Migration Guide in the Atlas documentation.
The following example shows an AtlasDeployment custom resource
specification configured for a Flex cluster:
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: test-cluster-name namespace: mongodb-atlas-system spec: projectRef: name: my-project flexSpec: name: flex-cluster tags: - key: "environment" value: "production" providerSettings: backingProviderName: AWS regionName: US_EAST_1
Serverless Instance Example
Note
Don't specify values for fields under spec.serverlessSpec because Serverless instances are deprecated. Instead, specify fields under spec.flexSpec. To learn more, see Migration to Flex Clusters.
The following example shows an AtlasDeployment custom resource
specification configured for a Serverless instance:
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: test-cluster-name namespace: mongodb-atlas-system spec: projectRef: name: development serverlessSpec: name: serverless-instance tags: - key: "environment" value: "production" providerSettings: providerName: AWS regionName: US_EAST_1
Multi-Region Cluster Example
Clusters can span regions and cloud service providers. To learn more, see Considerations.
Note
While the Atlas Cluster API
Resource sends requests using the
v1.5 Atlas API versions, the Atlas Kubernetes Operator apiVersion field
uses v1. In this case, v1 refers to the version of
the Kubernetes API.
The following example shows an AtlasDeployment custom
resource specification configured for multi-region clusters:
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: my-atlas-cluster spec: projectRef: name: my-project deploymentSpec: clusterType: REPLICASET name: tenantCluster tags: - key: "environment" value: "production" replicationSpecs: - zoneName: Zone 1 regionConfigs: priority: 7 - electableSpecs: instanceSize: M10 nodeCount: 3 providerName: AWS regionName: US_EAST_1
Multiple Cloud Service Providers Example
The following example shows an AtlasDeployment custom resource
specification configured to span multiple cloud service providers:
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: my-atlas-cluster spec: projectRef: name: my-project deploymentSpec: clusterType: REPLICASET name: tenantCluster tags: - key: "environment" value: "production" replicationSpecs: - regionConfigs: - electableSpecs: instanceSize: M10 nodeCount: 3 providerName: AWS regionName: US_EAST_1 priority: 7 - electableSpecs: instanceSize: M10 nodeCount: 2 providerName: AZURE regionName: US_EAST_2 priority: 6 - electableSpecs: instanceSize: M10 nodeCount: 2 providerName: GCP regionName: CENTRAL_US priority: 5
Search Index Example
The following example shows an AtlasDeployment custom resource
specification configured to create a search index for the collection
listingsAndReviews and grades:
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: my-atlas-cluster namespace: mongodb-atlas-system spec: deploymentSpec: backupEnabled: true clusterType: REPLICASET name: Test-cluster-M10 replicationSpecs: - regionConfigs: - backingProviderName: AWS electableSpecs: instanceSize: M10 nodeCount: 3 priority: 7 providerName: AWS regionName: US_EAST_1 zoneName: Zone 1 searchIndexes: - DBName: sample_training collectionName: grades name: test-vector-search-index type: vectorSearch vectorSearch: fields: - numDimensions: 1000 path: student_id similarity: euclidean type: vector - DBName: sample_airbnb collectionName: listingsAndReviews name: my-index search: mappings: dynamic: true searchConfigurationRef: name: atlassearchindexconfig-sample namespace: mongodb-atlas-system type: search terminationProtectionEnabled: false projectRef: name: my-project namespace: mongodb-atlas-system
Search Nodes Example
The following example shows an AtlasDeployment custom resource
specification configured to create search nodes:
apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: my-atlas-cluster namespace: mongodb-atlas-system spec: deploymentSpec: backupEnabled: true clusterType: REPLICASET name: Test-cluster-M10 replicationSpecs: - regionConfigs: - backingProviderName: AWS electableSpecs: instanceSize: M10 nodeCount: 3 priority: 7 providerName: AWS regionName: US_EAST_1 zoneName: Zone 1 searchNodes: - instanceSize: S20_HIGHCPU_NVME nodeCount: 2
Parameters
AtlasDeployment
AtlasDeployment is the Schema for the atlasdeployments API
Name | Type | Description | Required |
|---|---|---|---|
| string | atlas.mongodb.com/v1 | true |
| string |
| true |
| object | Refer to the Kubernetes | true |
| object |
| false |
| object |
| false |
AtlasDeployment.spec
AtlasDeploymentSpec defines the target state of AtlasDeployment. Only one of DeploymentSpec, AdvancedDeploymentSpec and ServerlessSpec should be defined.
Name | Type | Description | Required |
|---|---|---|---|
| object | Reference to the backup schedule for the | false |
| object | Name of the secret containing Atlas | false |
| object | Configuration for the advanced (v1.5) deployment | false |
| object |
| false |
| object | Configuration for the Flex cluster | false |
| object |
| false |
| object |
| false |
| object | Configuration for the serverless deployment | false |
| boolean |
| false |
AtlasDeployment.spec.backupRef
Reference to the backup schedule for the AtlasDeployment.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasDeployment.spec.connectionSecret
Name of the secret containing Atlas API private and public keys.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names | true |
AtlasDeployment.spec.deploymentSpec
Configuration for the advanced (v1.5) deployment API https://www.mongodb.com/docs/atlas/reference/api/clusters/
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the advanced deployment as it appears in Atlas.
After Atlas creates the deployment, you can't change its name.
Can only contain
| true |
| boolean | Flag that indicates if the deployment uses Cloud Backups for backups. Applicable only for M10``+ deployments. | false |
| object | Configuration of | false |
| enum | Type of the deployment that you want to create.
The parameter is required if | false |
| enum | Config Server Management Mode for creating or updating a sharded cluster.
Enum: | false |
| []object | List that contains Global Cluster parameters that map zones to geographic regions. | false |
| integer | Capacity, in gigabytes, of the host's root volume.
Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 | false |
| enum | Cloud service provider that offers Encryption at Rest.
Enum: | false |
| []object | Collection of key-value pairs that tag and categorize the deployment.
Each key and value has a maximum length of 255 characters.
| false |
| []object | List that contains information to create a managed namespace in a specified Global Cluster to create. | false |
| string |
| false |
| string | Version of | false |
| boolean | Flag that indicates whether the deployment should be paused. | false |
| boolean | Flag that indicates the deployment uses continuous cloud backups. | false |
| []object | Configuration for deployment regions. | false |
| string | Root Certificate Authority that | false |
| []object | An array of | false |
| []object | Settings for Search Nodes for the cluster. Currently, at most one search node configuration may be defined. | false |
| []object | Key-value pairs for resource tagging. | false |
| boolean | Flag that indicates whether termination protection is enabled on the cluster. If set to true, | false |
| string | Method by which the cluster maintains the | false |
AtlasDeployment.spec.deploymentSpec.biConnector
Configuration of BI Connector for Atlas on this deployment. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger deployments.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Flag that indicates whether the Business Intelligence Connector for Atlas is | false |
| string | Source from which the | false |
AtlasDeployment.spec.deploymentSpec.customZoneMapping
Name | Type | Description | Required |
|---|---|---|---|
| string | Code that represents a | true |
| string | Human-readable label that identifies the | true |
AtlasDeployment.spec.deploymentSpec.labels
LabelSpec contains key-value pairs that tag and categorize the Cluster/DBUser
Name | Type | Description | Required |
|---|---|---|---|
| string | Key applied to tag and categorize this component. | true |
| string | Value set to the Key applied to tag and categorize this component. | true |
AtlasDeployment.spec.deploymentSpec.managedNamespaces
ManagedNamespace represents the information about managed namespace configuration.
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label of the | true |
| string | Human-readable label of the database to manage for this Global Cluster. | true |
| string | Database parameter used to divide the collection into shards. Global clusters require a compound shard key. This compound shard key combines the location parameter and the user-selected custom key. | false |
| boolean | Flag that indicates whether someone hashed the custom shard key for the specified collection.
If you set this value to false, | false |
| boolean | Flag that indicates whether someone hashed the custom shard key. If this parameter returns false, this cluster uses ranged sharding. | false |
| integer | Minimum number of chunks to create initially when sharding an empty collection with a hashed shard key. Maximum value is 8192. | false |
| boolean | Flag that indicates whether | false |
AtlasDeployment.spec.deploymentSpec.replicationSpecs
Name | Type | Description | Required |
|---|---|---|---|
| integer | Positive integer that specifies the number of shards to deploy in each specified zone.
If you set this value to 1 and | false |
| []object | Hardware specifications for nodes set for a given region.
Each | false |
| string | Human-readable label that identifies the zone in a Global Cluster. | false |
AtlasDeployment.spec.deploymentSpec.replicationSpecs.regionConfigs
Name | Type | Description | Required |
|---|---|---|---|
| object | Hardware specifications for analytics nodes deployed in the region. | false |
| object | Options that determine how this cluster handles resource scaling. | false |
| enum | Cloud service provider on which the host for a multi-tenant deployment is provisioned.
This setting only works when " | false |
| object | Hardware specifications for nodes deployed in the region. | false |
| integer | Precedence is given to this region when a primary election occurs.
If your | false |
| enum | Enum: | false |
| object | Hardware specifications for read only nodes deployed in the region. | false |
| string | Physical location of your | false |
AtlasDeployment.spec.deploymentSpec.replicationSpecs.regionConfigs.analyticsSpecs
Hardware specifications for analytics nodes deployed in the region.
Name | Type | Description | Required |
|---|---|---|---|
| integer | Disk | false |
| enum | Disk | false |
| string | Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size. | false |
| integer | Number of nodes of the given type for | false |
AtlasDeployment.spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling
Options that determine how this cluster handles resource scaling.
Name | Type | Description | Required |
|---|---|---|---|
| object | Collection of settings that configure how a deployment might scale its deployment tier and whether the deployment can scale down. | false |
| object | Flag that indicates whether disk auto-scaling is enabled. The default is true. | false |
AtlasDeployment.spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute
Collection of settings that configure how a deployment might scale its deployment tier and whether the deployment can scale down.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Flag that indicates whether deployment tier auto-scaling is enabled. The default is false. | false |
| string | Maximum instance size to which your deployment can automatically scale (such as | false |
| string | Minimum instance size to which your deployment can automatically scale (such as | false |
| boolean | Flag that indicates whether the deployment tier may scale down. Atlas requires this parameter if " | false |
AtlasDeployment.spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB
Flag that indicates whether disk auto-scaling is enabled. The default is true.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Flag that indicates whether this cluster enables disk auto-scaling. The maximum memory allowed for the selected cluster tier and the oplog size can limit storage auto-scaling. | false |
AtlasDeployment.spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs
Hardware specifications for nodes deployed in the region.
Name | Type | Description | Required |
|---|---|---|---|
| integer | Disk | false |
| enum | Disk | false |
| string | Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size. | false |
| integer | Number of nodes of the given type for | false |
AtlasDeployment.spec.deploymentSpec.replicationSpecs.regionConfigs.readOnlySpecs
Hardware specifications for read only nodes deployed in the region.
Name | Type | Description | Required |
|---|---|---|---|
| integer | Disk | false |
| enum | Disk | false |
| string | Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size. | false |
| integer | Number of nodes of the given type for | false |
AtlasDeployment.spec.deploymentSpec.searchIndexes
SearchIndex is the CRD to configure part of the Atlas Search Index.
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label that identifies the database that contains the collection with one or more Atlas Search indexes. | true |
| string | Human-readable label that identifies the collection that contains one or more Atlas Search indexes. | true |
| string | Human-readable label that identifies this index. Must be unique for a deployment. | true |
| enum | Type of the index.
Enum: search, | true |
| object | Atlas | false |
| object | Atlas vector search index configuration. | false |
AtlasDeployment.spec.deploymentSpec.searchIndexes.search
Atlas search index configuration.
Name | Type | Description | Required |
|---|---|---|---|
| object | Index specifications for the collection's fields. | true |
| object | A reference to the | true |
| []object | Rule sets that map words to their | false |
AtlasDeployment.spec.deploymentSpec.searchIndexes.search.mappings
Index specifications for the collection's fields.
Name | Type | Description | Required |
|---|---|---|---|
|
| Indicates whether the index uses static, default dynamic, or configurable | false |
|
| One or more field specifications for the Atlas Search index. Required if mapping.dynamic is omitted or set to false. | false |
AtlasDeployment.spec.deploymentSpec.searchIndexes.search.searchConfigurationRef
A reference to the AtlasSearchIndexConfig custom resource.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasDeployment.spec.deploymentSpec.searchIndexes.search.synonyms
Synonym represents "Synonym" type of Atlas Search Index.
Name | Type | Description | Required |
|---|---|---|---|
| enum | Specific pre-defined method chosen to apply to the synonyms to be searched. Enum: lucene.standard, lucene.simple, lucene.whitespace, lucene.keyword, lucene.arabic, lucene.armenian, lucene.basque, lucene.bengali, lucene.brazilian, lucene.bulgarian, lucene.catalan, lucene.chinese, lucene.cjk, lucene.czech, lucene.danish, lucene.dutch, lucene.english, lucene.finnish, lucene.french, lucene.galician, lucene.german, lucene.greek, lucene.hindi, lucene.hungarian, lucene.indonesian, lucene.irish, lucene.italian, lucene.japanese, lucene.korean, lucene.kuromoji, lucene.latvian, lucene.lithuanian, lucene.morfologik, lucene.nori, lucene.norwegian, lucene.persian, lucene.portuguese, lucene.romanian, lucene.russian, lucene.smartcn, lucene.sorani, lucene.spanish, lucene.swedish, lucene.thai, lucene.turkish, lucene.ukrainian | true |
| string | Human-readable label that identifies the synonym definition. Each | true |
| object | Data set that stores the mapping one or more words map to one or more synonyms of those words. | true |
AtlasDeployment.spec.deploymentSpec.searchIndexes.search.synonyms.source
Data set that stores the mapping one or more words map to one or more synonyms of those words.
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label that identifies the | true |
AtlasDeployment.spec.deploymentSpec.searchIndexes.vectorSearch
Atlas vector search index configuration.
Name | Type | Description | Required |
|---|---|---|---|
|
| Array of | true |
AtlasDeployment.spec.deploymentSpec.searchNodes
Name | Type | Description | Required |
|---|---|---|---|
| enum | Hardware specification for the Search Node instance sizes.
Enum: | false |
| integer | Number of Search Nodes in the cluster. Minimum: 2 Maximum: 32 | false |
AtlasDeployment.spec.deploymentSpec.tags
TagSpec holds a key-value pair for resource tagging on this deployment.
Name | Type | Description | Required |
|---|---|---|---|
| string | Constant that defines the set of the tag. | true |
| string | Variable that belongs to the set of the tag. | true |
AtlasDeployment.spec.externalProjectRef
externalProjectRef holds the parent Atlas project ID. Mutually exclusive with the "projectRef" field.
Name | Type | Description | Required |
|---|---|---|---|
| string |
| true |
AtlasDeployment.spec.flexSpec
Configuration for the Flex cluster API. https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label that identifies the instance. | true |
| object | Group of cloud provider settings that configure the provisioned | true |
| []object | List that contains key-value pairs between 1 and 255 characters in length for tagging and categorizing the instance. | false |
| boolean | Flag that indicates whether termination protection is enabled on the cluster.
If set to true, | false |
AtlasDeployment.spec.flexSpec.providerSettings
Group of cloud provider settings that configure the provisioned MongoDB flex cluster.
Name | Type | Description | Required |
|---|---|---|---|
| enum | Cloud service provider on which
Enum: | true |
| string | Human-readable label that identifies the geographic location of your
| true |
AtlasDeployment.spec.flexSpec.tags
TagSpec holds a key-value pair for resource tagging on this deployment.
Name | Type | Description | Required |
|---|---|---|---|
| string | Constant that defines the set of the tag. | true |
| string | Variable that belongs to the set of the tag. | true |
AtlasDeployment.spec.processArgs
ProcessArgs allows modification of Advanced Configuration Options.
Name | Type | Description | Required |
|---|---|---|---|
| string | String that indicates the default level of acknowledgment requested from | false |
| string | String that indicates the default level of acknowledgment requested from | false |
| boolean | Flag that indicates whether to fail the operation and return an error when you insert or update documents where all indexed entries exceed 1024 bytes. If you set this to false, mongod writes documents that exceed this limit, but doesn't index them. | false |
| boolean | Flag that indicates whether the cluster allows execution of operations that perform server-side executions of | false |
| string | String that indicates the minimum | false |
| boolean | Flag that indicates whether the cluster disables executing any query that requires a collection scan to return results. | false |
| string | Minimum retention window for cluster's oplog expressed in hours. A value of null indicates that the cluster uses the default minimum oplog window that | false |
| integer | Number that indicates the storage limit of a cluster's oplog expressed in megabytes. A value of null indicates that the cluster uses the default oplog size that Atlas calculates. Format: int64 | false |
| integer | Number that indicates the documents per database to sample when gathering schema information. Format: int64 | false |
| integer | Number that indicates the interval in seconds at which the mongosqld process re-samples data to create its relational schema. Format: int64 | false |
AtlasDeployment.spec.projectRef
projectRef is a reference to the parent AtlasProject resource. Mutually exclusive with the "externalProjectRef" field.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasDeployment.spec.serverlessSpec
Configuration for the serverless deployment API. https://www.mongodb.com/docs/atlas/reference/api/serverless-instances/ DEPRECATED: Serverless instances are deprecated. See https://dochub.mongodb.org/core/atlas-flex-migration for details.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the serverless deployment as it appears in Atlas.
After Atlas creates the deployment, you can't change its name.
Can only contain | true |
| object | Configuration for the provisioned hosts on which | true |
| object | Serverless Backup Options | false |
| []object | List that contains the private endpoint configurations for the Serverless instance.
| false |
| []object | Key-value pairs for resource tagging. | false |
| boolean | Flag that indicates whether termination protection is enabled on the cluster. If set to true, | false |
AtlasDeployment.spec.serverlessSpec.providerSettings
Configuration for the provisioned hosts on which MongoDB runs. The available options are specific to the cloud service provider.
Name | Type | Description | Required |
|---|---|---|---|
| enum | Cloud service provider on which Atlas provisions the hosts.
Enum: | true |
| object | Range of instance sizes to which your deployment can scale.
| false |
| enum | Cloud service provider on which the host for a multi-tenant deployment is provisioned.
This setting only works when " | false |
| integer | Disk | false |
| string | Type of disk if you selected Azure as your cloud service provider.
| false |
| boolean | Flag that indicates whether the Amazon | false |
| string | Atlas provides different deployment tiers, each with a default storage capacity and | false |
| string | Physical location of your | false |
| enum | Disk | false |
AtlasDeployment.spec.serverlessSpec.providerSettings.autoScaling
Range of instance sizes to which your deployment can scale. DEPRECATED: The value of this field doesn't take any effect.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Flag that indicates whether autopilot mode for Performance Advisor is enabled.
The default is false.
| false |
| object | Collection of settings that configure how a deployment might scale its deployment tier and whether the deployment can scale down. | false |
| boolean | Flag that indicates whether disk auto-scaling is enabled. The default is true. | false |
AtlasDeployment.spec.serverlessSpec.providerSettings.autoScaling.compute
Collection of settings that configure how a deployment might scale its deployment tier and whether the deployment can scale down.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Flag that indicates whether deployment tier auto-scaling is enabled. The default is false. | false |
| string | Maximum instance size to which your deployment can automatically scale (such as | false |
| string | Minimum instance size to which your deployment can automatically scale (such as | false |
| boolean | Flag that indicates whether the deployment tier may scale down. Atlas requires this parameter if " | false |
AtlasDeployment.spec.serverlessSpec.backupOptions
Serverless Backup Options
Name | Type | Description | Required |
|---|---|---|---|
| boolean |
| false |
AtlasDeployment.spec.serverlessSpec.privateEndpoints
ServerlessPrivateEndpoint configures private endpoints for the Serverless instances. DEPRECATED: Serverless private endpoints are deprecated. See https://dochub.mongodb.org/core/atlas-flex-migration for details.
Name | Type | Description | Required |
|---|---|---|---|
| string |
| false |
| string | Name is the | false |
| string |
| false |
AtlasDeployment.spec.serverlessSpec.tags
TagSpec holds a key-value pair for resource tagging on this deployment.
Name | Type | Description | Required |
|---|---|---|---|
| string | Constant that defines the set of the tag. | true |
| string | Variable that belongs to the set of the tag. | true |
AtlasDeployment.status
AtlasDeploymentStatus defines the observed state of AtlasDeployment.
Name | Type | Description | Required |
|---|---|---|---|
| []object | Conditions is the list of statuses showing the current state of the Atlas Custom Resource | true |
| object |
| false |
| object | List that contains key value pairs to map zones to geographic regions.
These pairs map an | false |
| []object | List that contains a namespace for a Global Cluster. | false |
| string |
| false |
| string |
| false |
| integer |
| false |
| []object | Details that explain how | false |
| []object |
| false |
| []object |
| false |
| string |
| false |
AtlasDeployment.status.conditions
Condition describes the state of an Atlas Custom Resource at a certain point.
Name | Type | Description | Required |
|---|---|---|---|
| string | Status of the condition; one of True, False, Unknown. | true |
| string | Type of Atlas Custom Resource condition. | true |
| string | Last time the condition transitioned from one status to another.
Represented in | false |
| string | A | false |
| string | The | false |
AtlasDeployment.status.connectionStrings
ConnectionStrings is a set of connection strings that your applications use to connect to this cluster.
Name | Type | Description | Required |
|---|---|---|---|
| string | Network-peering-endpoint-aware mongodb:// connection strings for each interface | false |
| []object | Private endpoint connection strings. Each object describes the connection strings you can use to connect to this cluster through a private endpoint. Atlas returns this parameter only if you deployed a private endpoint to all regions to which you deployed this cluster's nodes. | false |
| string | Network-peering-endpoint-aware mongodb+srv:// connection strings for each interface | false |
| string | Public mongodb:// connection string for this cluster. | false |
| string | Public mongodb+srv:// connection string for this cluster. | false |
AtlasDeployment.status.connectionStrings.privateEndpoint
PrivateEndpoint connection strings. Each object describes the connection strings you can use to connect to this cluster through a private endpoint. Atlas returns this parameter only if you deployed a private endpoint to all regions to which you deployed this cluster's nodes.
Name | Type | Description | Required |
|---|---|---|---|
| string | Private-endpoint-aware mongodb:// connection string for this private endpoint. | false |
| []object | Private endpoint through which you connect to Atlas when you use | false |
| string | Private-endpoint-aware mongodb+srv:// connection string for this private endpoint. | false |
| string | Private endpoint-aware connection string optimized for sharded clusters that uses the | false |
| string | Type of | false |
AtlasDeployment.status.connectionStrings.privateEndpoint.endpoints
Endpoint through which you connect to Atlas
Name | Type | Description | Required |
|---|---|---|---|
| string | Unique identifier of the private endpoint. | false |
| string | Private | false |
| string | Cloud provider to which you deployed the private endpoint. Atlas returns | false |
| string | Region to which you deployed the private endpoint. | false |
AtlasDeployment.status.customZoneMapping
List that contains key value pairs to map zones to geographic regions. These pairs map an ISO 3166-1a2 location code, with an ISO 3166-2 subdivision code when possible, to a unique 24-hexadecimal string that identifies the custom zone.
Name | Type | Description | Required |
|---|---|---|---|
| map[string]string | List that contains key value pairs to map zones to geographic regions.
These pairs map an | false |
| string | Error message for failed Custom Zone Mapping. | false |
| string | Status of the Custom Zone Mapping. | false |
AtlasDeployment.status.managedNamespaces
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label of the | true |
| string | Human-readable label of the database to manage for this Global Cluster. | true |
| string | Database parameter used to divide the collection into shards. Global clusters require a compound shard key. This compound shard key combines the location parameter and the user-selected custom key. | false |
| string | Error message for a failed Managed Namespace. | false |
| boolean | Flag that indicates whether someone hashed the custom shard key for the specified collection.
If you set this value to false, | false |
| boolean | Flag that indicates whether someone hashed the custom shard key. If this parameter returns false, this cluster uses ranged sharding. | false |
| integer | Minimum number of chunks to create initially when sharding an empty collection with a hashed shard key. | false |
| boolean | Flag that indicates whether | false |
| string | Status of the Managed Namespace. | false |
AtlasDeployment.status.replicaSets
Name | Type | Description | Required |
|---|---|---|---|
| string | Unique 24-hexadecimal digit string that identifies the replication object for a shard in a Cluster. | true |
| string | Human-readable label that describes the zone this shard belongs to in a Global Cluster. | false |
AtlasDeployment.status.searchIndexes
Name | Type | Description | Required |
|---|---|---|---|
| string | Unique 24-hexadecimal digit string that identifies this Atlas Search index. | true |
| string | Details on the status of the search index. | true |
| string | Human-readable label that identifies this index. | true |
| string | Condition of the search index. | true |
AtlasDeployment.status.serverlessPrivateEndpoints
Name | Type | Description | Required |
|---|---|---|---|
| string |
| false |
| string |
| false |
| string |
| false |
| string |
| false |
| string | Name is the | false |
| string |
| false |
| string |
| false |
| string |
| false |
| string | Status of the | false |