AtlasDeployment Recurso personalizado

Migração para clusters flexíveis

Alterações significativas com o Atlas Kubernetes Operator 2.0

Sobre o Recurso Personalizado AtlasDeployment

O recurso personalizado do AtlasDeployment configura seu cluster MongoDB ou cluster Flex no Atlas. Quando você cria o recurso personalizado AtlasDeployment, o Atlas Kubernetes Operator tenta criar ou atualizar um cluster ou um cluster flexível no Atlas.

O Atlas Kubernetes Operator realiza uma das seguintes ação, dependendo dos valores que você especificar no recurso personalizado AtlasDeployment :

• 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.

Criar um cluster gratuito leva menos de 15 segundos.

A criação ou atualização de um cluster Flex ou cluster dedicado pode levar até 10 minutos. O Atlas Kubernetes Operator monitora o processo de atualização.

Você pode executar o seguinte comando para verificar o status:

kubectl get atlasdeployment -o yaml

O exemplo a seguir mostra a seção de status de um cluster que está provisionando:

status:
  conditions:
  - lastTransitionTime: "2024-03-18T16:32:43Z"
    status: "False"
    type: ClusterReady
    reason: ClusterCreating
    message: Cluster is provisioning

O status ClusterReady mudará para True quando o cluster ou a instância sem servidor estiver pronto.

Exemplos

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

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

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

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

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

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

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

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

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

Parâmetros

Esta seção descreve alguns dos principais parâmetros de recursos personalizados AtlasDeployment disponíveis.

• For a full list of available parameters for clusters, see the Atlas Clusters API.

• Para obter uma lista completa dos parâmetros disponíveis para clusters flexíveis, consulte a APIde clusters flexíveis do Atlas .

Consulte Notas sobre transição para clusters flexíveis para obter informações completas sobre alterações.

Para personalizar suas especificações, consulte estas descrições, os exemplos disponíveis e a documentação da API .

spec.backupRef

Tipo: objeto

Opcional

Lista que contém os detalhes do Recurso PersonalizadoAtlasBackupSchedule que você deseja aplicar. Você pode especificar um agendamento de backup por cluster.

spec.backupRef.name

Tipo: string

Opcional

metadata.name valor dentro do Recurso PersonalizadoAtlasBackupSchedule para o agendamento de backup que você deseja aplicar. Você pode especificar apenas um agendamento de backup por cluster, mas pode usar o mesmo agendamento de backup para vários clusters.

Se você omitir este parâmetro, o Atlas não aplicará sua configuração de cópia de segurança a este cluster.

spec.backupRef.namespace

Tipo: string

Opcional

String que indica o namespace que contém o Recurso PersonalizadoAtlasBackupSchedule para o agendamento de backup que você deseja aplicar.

spec.configServerManagementMode

Tipo: string

Opcional

Padrão: ATLAS_MANAGED

Configuração que define o Modo de Gerenciamento do Servidor para criar ou atualizar um cluster fragmentado. Os valores possíveis são:

• ATLAS_MANAGED: o Atlas pode alternar automaticamente o tipo de servidor de configuração do cluster para desempenho e economia ideais.

• FIXED_TO_DEDICATED: o cluster sempre usa um servidor de configuração dedicado .

Saiba mais sobre os servidores de configuração de cluster fragmentado MongoDB.

spec.connectionSecret.name

Tipo: string

Condicional

Nome do segredo opaco segredo que contém o ID da organização e as chaves de API que o Atlas Kubernetes Operator usa para se conectar ao Atlas. Se não for especificado, o Atlas Kubernetes Operator voltará para:

• O parâmetro spec.connectionSecretRef.name do atlasProjectpai

• O segredo global padrão, se spec.connectionSecretRef.name estiver indefinido para o atlasProjectpai

Este parâmetro é obrigatório para CRDs independentes.

spec.deploymentSpec

Tipo: array

Condicional

List that contains the cluster parameters from the API. For a full list of available parameters, see the Atlas Clusters API.

Importante

You must specify spec.deploymentSpec or spec.flexSpec in your configuration.

Consulte Notas sobre transição para clusters flexíveis para obter informações completas sobre alterações.

spec.deploymentSpec.name

Tipo: string

Condicional

string que identifica o nome do cluster. O nome deve conter apenas letras, números e traços e não pode ser modificado após a criação do sistema.

spec.deploymentSpec.clusterType

Tipo: string

Condicional

Etiqueta legível para humanos que identifica o tipo de cluster a ser criado.

Quando você deve usar esse parâmetro?

Condição	necessidade
You set spec.deploymentSpec.replicationSpecs.	Obrigatório
Você está implantando clusters globais.	Obrigatório
Você está implementando conjuntos de réplicas não globais e clusters fragmentados.	Opcional

Atlas aceita:

Valor	Tipo de cluster
Conjunto de réplicas	Conjunto de réplicas
Fragmentado	cluster fragmentado
Geofragmentado	Cluster global

spec.deploymentSpec.customZoneMapping

Tipo: array

Obrigatório

List that contains Global Cluster parameters that map zones to geographic regions. For a full list of available parameters, see the Atlas Global Clusters API.

spec.deploymentSpec.customZoneMapping.location

Tipo: string

Obrigatório

Código que representa um local mapeado para uma zona no seu cluster global.

spec.deploymentSpec.customZoneMapping.zone

Tipo: string

Obrigatório

Human-readable label that identifies the zone in your Global Cluster.

spec.deploymentSpec.diskSizeGB

Tipo: número

Opcional

Capacidade, em gigabytes, que indica o volume raiz do host. Aumente esse número para adicionar capacidade, até um valor máximo possível de 4096 (4 TB). Você deve especificar um número positivo para esse valor.

Você não pode definir esse valor para clusters com SSDs NVMe locais.

Observação

If you enable auto-scaling for diskGB in any region, you can't edit this option. To learn more, see spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabled.

O tamanho mínimo do disco para cluster dedicado é de 10 GB para AWS e Google Cloud. Se você especificar essa configuração com um tamanho de disco menor, o Atlas assumirá como padrão o valor mínimo do tamanho do disco.

Se a implantação de banco de dados incluir nós Azure, esse valor deve corresponder a um tipo de disco Azure existente (8, 16, 32, 64, 128, 256, 512, 1024, 2048 ou 4096).

O Atlas calcula as cobranças de armazenamento de forma diferente, dependendo se você escolher o valor padrão ou um valor personalizado.

Atlas has disk capacity limits on single replica sets, scaling up to 4 TB for higher cluster tiers. To expand the total cluster storage beyond default limits, you can enable extended storage in the Project Settings. To accommodate further scaling in the future, we recommend that you enable sharding for long-term expansion.

Se o seu comando de banco de dados abranger provedores de serviços de cloud, esse valor assumirá como padrão o padrão mínimo dos provedores envolvidos.

To learn more, see Storage Capacity.

spec.deploymentSpec.encryptionAtRestProvider

Tipo: string

Opcional

Provedor de serviços de cloud que managed a chave do cliente para esse cluster. Você deve definir esse valor para habilitar a criptografia em descanso usando chaves managed pelo cliente para esse cluster, que fornece uma camada adicional de criptografia. Para saber mais, consulte Criptografar dados usando um serviço de gerenciamento de chaves.

O Atlas aceita os seguintes valores:

Valor	Provedor de nuvem
AWS	Amazon AWS
GCP	Google cloud
AZURE	Microsoft Azure
none	Sem fornecedor, o cluster não criptografa dados usando chaves gerenciadas pelo consumidor.

spec.deploymentSpec.managedNamespaces

Tipo: array

Obrigatório

List that contains information to create a managed namespace in a specified Global Cluster to create. For a full list of available parameters, see the Atlas Global Clusters API.

spec.deploymentSpec.managedNamespaces.collection

Tipo: string

Obrigatório

Rótulo legível por humanos da coleção a ser gerenciada neste cluster global.

spec.deploymentSpec.managedNamespaces.db

Tipo: string

Obrigatório

Etiqueta legível para humanos do banco de banco de dados a ser gerenciado neste cluster global.

spec.deploymentSpec.managedNamespaces.isCustomShardKeyHashed

Tipo: booleano

Opcional

Sinalizador que indica se o hash da chave de shard personalizada deve ser feito para a collection especificada. Este parâmetro é padronizado como false.

• Defina como true para habilitar uma chave de shard personalizada para a collection.

• Set to false to disable a custom shard key for the collection. If diabled, MongoDB uses ranged sharding.

To learn more, see Hashed Shard Keys.

spec.deploymentSpec.managedNamespaces.isCustomShardKeyUnique

Tipo: booleano

Opcional

Sinalizador que indica se a chave de shard personalizada para a collection especificada é exclusiva. Este parâmetro é padronizado como false.

• Defina como true para habilitar uma chave de shard personalizada exclusiva para a collection.

• Defina como false para desabilitar uma chave de shard personalizada exclusiva para a collection.

spec.deploymentSpec.managedNamespaces.numInitialChunks

Tipo: inteiro

Opcional

Minimum number of chunks to initially create when sharding an empty collection with a hashed shard key.

Para saber mais, consulte Shard a Global Collection.

spec.deploymentSpec.managedNamespaces.presplitHashedZones

Tipo: booleano

Opcional

Sinalizador que indica se o MongoDB cloud deve criar e distribuir partes iniciais para uma collection vazia ou inexistente. Este parâmetro é padronizado como false.

• Defina como true para que o MongoDB cloud crie e distribua partes iniciais para uma collection vazia ou inexistente.

• Defina como false para que o MongoDB cloud não crie e distribua partes iniciais para uma collection vazia ou inexistente.

spec.deploymentSpec.mongoDBMajorVersion

Tipo: string

Opcional

Versão do cluster a ser implementada. O Atlas suporta as seguintes versões MongoDB para clusters do M10+ :

• 5.0

• 6.0

• 7.0

• 8.0

As seguintes condições produzem os seguintes resultados:

Condição	Resultado
You omit this parameter and you omit the spec.deploymentSpec.versionReleaseSystem parameter.	O Atlas implementa um cluster que executa o MongoDB 7.0.
You omit this parameter and you set the spec.deploymentSpec.versionReleaseSystem parameter to LTS.	O Atlas implementa um cluster que executa o MongoDB 7.0.
Atlas deprecated M2 and M5 clusters and Serverless instances. To learn more, see Migration to Flex Clusters. Set the spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize parameter to M0, M2, or M5.	Você deve distribuir o MongoDB 7.0 ou posterior.
Você especifica este parâmetro.	O Atlas sempre implementa o cluster com a versão de patch estável mais recente da versão especificada.
You set the spec.deploymentSpec.versionReleaseSystem parameter to CONTINUOUS.	Você deve omitir este parâmetro.

spec.deploymentSpec.pitEnabled

Tipo: booleano

Condicional

Observação

O Atlas desativou os clusters M2 e M5 e as instâncias sem servidor. O Atlas migrou todos os clusters M2 e M5 para clusters Flex. Para instâncias sem servidor, o Atlas migrou instâncias para clusters gratuitos, clusters flexíveis ou clusters dedicados de acordo com seu uso.

Para preservar a compatibilidade com versões anteriores das APIs por um período de tempo, o Atlas continuará permitindo que esses clusters migrados sejam gerenciados por meio das mesmas APIs (antigas e novas APIs), inclusive ao usar o Atlas Kubernetes Operator. A compatibilidade com versões anteriores das APIs permanecerá em vigor até 2026 de janeiro, quando as APIs antigas serão removidas e apenas as APIs relacionadas a clusters Flex permanecerão em vigor.

O suporte para pontos de extremidade privados em instâncias sem servidor terminou em 2025 de março. Você deve atualizar suas configurações do Atlas Kubernetes Operator para remover pontos de extremidade privados até março de 2025. Você deve remover todos os recursos restantes das instâncias M2, M5 e sem servidor das configurações do Atlas Kubernetes Operator antes de janeiro de 2026.

If your workloads require Private Endpoints or Continuous Backup, switch to Atlas Dedicated Clusters. To learn more, see Migration to Flex Clusters and the Atlas Flex Migration Guide.

Configuração que habilita o backup em cloud contínuo. Para habilitar o backup em cloud contínuo, você deve especificar true para esta configuração.

spec.deploymentSpec.replicationSpecs

Tipo : array de objetos

Condicional

List that contains the configurations for your cluster regions. Use this parameter for multi-region clusters. You must set either spec.deploymentSpec.replicationSpecs.regionConfigs.regionName or spec.deploymentSpec.replicationSpecs.

Quando você deve usar esse parâmetro?

Condição	necessidade	Values
Você está implantando clusters globais.	Obrigatório	Cada objeto na array representa uma zona onde o Atlas implanta os nós do seu cluster.
Você está implementando conjuntos de réplicas não globais e clusters fragmentados.	Opcional	Essa array tem um objeto que representa onde o Atlas distribui os nós do cluster.

If you specify this parameter, you must also specify spec.deploymentSpec.clusterType and spec.deploymentSpec.replicationSpecs.numShards.

spec.deploymentSpec.replicationSpecs.numShards

Tipo: inteiro

Condicional

Número inteiro positivo que especifica o número de fragmentos a serem distribuídos para um cluster fragmentado.

If you use the spec.deploymentSpec.replicationSpecs parameter, you must set this parameter.

O Atlas aceita de 1 a 50, inclusive. O valor padrão é 1.

• If you specify a value of 1 and you set spec.deploymentSpec.clusterType to SHARDED, Atlas deploys a single-shard sharded cluster.

• If you specify 1 and you set spec.deploymentSpec.clusterType to REPLICASET, Atlas deploys a replica set.

  Não crie um cluster fragmentado com um único fragmento para ambientes de produção. Os clusters de fragmentos únicos não fornecem os mesmos benefícios que as configurações de vários fragmentos.

  Dica

  • Fragmentação

  • Número de nós

Aviso

When you use a sharded cluster, MongoDB requires that your applications connect to a mongos instance to ensure that your applications interact with the shards and other components of the sharded cluster properly. If you migrate from a replica set to a sharded cluster, your applications must restart to enable the connection to the cluster's mongos. As a result, the Atlas Admin API prevents you from migrating a replica set directly to a sharded cluster with more than one shard. After you successfully migrate your replica set to a single shard cluster and reset your application connections, you can add additional shards to the cluster.

spec.deploymentSpec.replicationSpecs.regionConfigs

Tipo: array

Obrigatório

Especificações de hardware para nós definidos para uma determinada região. Cada objeto regionConfigs descreve a prioridade da região nas eleições e o número e tipo de nós do MongoDB que o Atlas implementa na região.

Cada objeto regionConfigs deve ter um objeto analyticsSpecs , um objeto electableSpecs ou um objeto readOnlySpecs .

• M0, M2 ou clusters M5 exigem apenas electableSpecs.

• O cluster dedicado pode especificar qualquer uma dessas especificações, mas deve ter pelo menos um objeto electableSpecs dentro de um replicationSpec.

• Toda especificação de hardware deve usar o mesmo instanceSize.

spec.deploymentSpec.replicationSpecs.regionConfigs.analyticsSpecs

Tipo: objeto

Opcional

Especificações de hardware para nós de analítica necessários na região. Os nós de analítica lidam com dados analíticos, como reportar queries do BI Connector for Atlas. Os nós de analítica são somente para leitura e nunca podem se tornar os primary.

Se você não especificar este parâmetro, o Atlas não implantará nenhuma analítica para esta região.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabled

Tipo: booleano

Opcional

Sinalizador que indica se o sistema de implantação de banco de dados habilita o auto-scaling de disco. Este parâmetro é padronizado como true.

• Defina como true para ativar o dimensionamento automático do disco.

• Defina como false para desabilitar o dimensionamento automático do disco.

The maximum amount of RAM for the selected cluster tier and the oplog size can limit storage auto-scaling. To learn more, see Customize Your Storage.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled

Tipo: booleano

Opcional

Sinalizador que indica se o auto-scaling do tamanho da instância está habilitado. Este parâmetro é padronizado como false.

• Set to true to enable instance size auto-caling. If enabled, you must specify a value for spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize.

• Defina como false para desabilitar o auto-scaling do tamanho da instância.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize

Tipo: string

Condicional

String that indicates the maximum instance size to which your database deployment can automatically scale (such as M40). You must specify this parameter if you set spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled to true.

Observação

Se você definir um tamanho máximo de instância menor que o tamanho da instância atual do sistema de banco de dados com o auto-scaling ativado, o Atlas dimensionará automaticamente o tamanho da instância atual para o valor máximo especificado.

Por exemplo, se o tamanho da instância atual do comando de banco de dados for M40 e você definir o tamanho máximo da instância como M30, o Atlas escalará automaticamente o tamanho da instância atual para M30.

If Atlas changes the current instance size and you don't change the spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize in Atlas Kubernetes Operator to match the new instance size, Atlas Kubernetes Operator displays a warning in the logs but doesn't prevent auto-scaling.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize

Tipo: string

Condicional

String that indicates the minimum instance size to which your database deployment can automatically scale (such as M10). You must specify this parameter if you set spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled to true.

Observação

Se você definir um tamanho mínimo de instância maior do que o tamanho da instância atual do sistema de banco de dados com o auto-scaling ativado, o Atlas dimensionará automaticamente o tamanho da instância atual para o valor mínimo especificado.

Por exemplo, se o tamanho da instância atual do comando de banco de dados for M10 e você definir o tamanho mínimo da instância como M30, o Atlas escalará automaticamente o tamanho da instância atual para M30.

If Atlas changes the current instance size and you don't change the spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize in Atlas Kubernetes Operator to match the new instance size, Atlas Kubernetes Operator displays a warning in the logs but doesn't prevent auto-scaling.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs

Tipo: objeto

Opcional

Especificações de hardware para nós elegíveis na região. Os nós elegíveis podem se tornar o primary e podem habilitar leituras locais.

Se você não especificar esta opção, o Atlas não implantará nós elegíveis na região.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize

Tipo: string

Condicional

Especificação de hardware para os tamanhos de instância nesta região. Cada tamanho de instância tem uma capacidade de armazenamento e memória padrão. O tamanho da instância selecionado se aplica a todos os hosts portadores de dados no tamanho da instância. Para saber mais, consulte os tamanhos de armazenamento personalizados da Amazon Web Services, GCP e Azure .

If you deploy a sharded cluster, or global cluster, you must choose an instance size of M30 or greater.

If you change the instance size name after you deploy your cluster, Atlas changes the database deployment to the instance size you specify unless it falls outside the range you specify in spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize and spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize with auto-scaling enabled. To learn more, see spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize and spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize.

Observação

If you have auto-scaling enabled for the compute field, you can't edit this option. To learn more, see spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled.

Observação

Você pode alterar essa configuração para atualizar um cluster M0 ou Flex para um cluster M10+. No entanto, você não pode usar essa configuração para atualizar um M0 ou um cluster Flex para outro cluster gratuito ou Flex

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.nodeCount

Tipo: inteiro

Condicional

Número de nós elegíveis para o Atlas implantar na região. Os nós elegíveis podem se tornar o primary e podem habilitar leituras locais.

O electableSpecs.nodeCount combinado em todos os objetos replicationSpecs.regionConfigs deve totalizar 3 , 5 ou 7 .

You can't create electable nodes if spec.deploymentSpec.replicationSpecs.regionConfigs.priority is 0.

spec.deploymentSpec.replicationSpecs.regionConfigs.priority

Tipo: inteiro

Obrigatório

A precedência é dada a essa região quando ocorre uma eleição do primário.

Se o seu regionConfigs tiver apenas readOnlySpecs, analyticsSpecs ou ambos, defina este valor como 0.

Se você tiver vários objeto regionConfigs (seu cluster é multirregional ou cloud), eles deverão ter prioridade em ordem decrescente. A maior prioridade é 7.

Exemplo

Defina sua região de maior prioridade como 7, sua segunda maior prioridade como 6 e sua região de terceira prioridade como 5. Se você não tiver nós elegíveis, defina esse valor como 0.

Se sua região definiu electableSpecs.nodeCount como 1 ou superior, ela deverá ter uma prioridade de exatamente um a menos do que outra região na array replicationSpecs.regionConfigs , a menos que seja a primary. A região de maior prioridade deve ter uma prioridade de 7. A prioridade mais baixa possível é 1 .

A região de prioridade 7 identifica a Região Preferencial do cluster. O Atlas coloca o nó primário na região preferencial. As prioridades 1 a 7 são exclusivas: não é possível atribuir uma determinada prioridade a mais de uma região por cluster.

Exemplo

Se você tiver três regiões, suas prioridades serão 7, 6 e 5 respectivamente. Se você adicionasse mais duas regiões para apoiar nós elegíveis, as prioridades dessas regiões seriam 4 e 3 , respectivamente.

spec.deploymentSpec.replicationSpecs.regionConfigs.providerName

Tipo: string

Condicional

Fornecedor de serviços de cloud no qual o Atlas provisiona os hosts.

AWS	Amazon AWS
GCP	Google Cloud Platform
AZURE	Microsoft Azure

spec.deploymentSpec.replicationSpecs.regionConfigs.regionName

Tipo: string

Condicional

Localização física do cluster MongoDB. A região que você escolhe pode afetar a latência de rede para clientes que acessam os bancos de dados.

Para obter uma lista completa dos valores de nome de região, consulte as páginas de referência do fornecedor de serviços em nuvem:

• AWS

• GCP

• Azure

For multi-region clusters, see spec.deploymentSpec.replicationSpecs. You must set either spec.deploymentSpec.replicationSpecs.regionConfigs.regionName or spec.deploymentSpec.replicationSpecs.

spec.deploymentSpec.replicationSpecs.regionConfigs.readOnlySpecs

Tipo: objeto

Opcional

Especificações de hardware para nós somente leitura na região. O nó somente leitura nunca pode se tornar o membro primary, mas pode habilitar leituras locais.

Se você não especificar este parâmetro, o Atlas não implantará nós somente leitura na região.

spec.deploymentSpec.replicationSpecs.zoneName

Tipo: string

Opcional

Human-readable label that identifies the zone in a Global Cluster. Provide this value only if you set spec.deploymentSpec.clusterType to GEOSHARDED.

spec.deploymentSpec.searchIndexes

Tipo: array

Opcional

Uma array de SearchIndex objetos com campos que descrevem o índice do Atlas Search . Cada objeto SearchIndex contém os seguintes campos:

Campo	Tipo	Descrição
name	string	Rótulo legível por humanos que identifica este índice. Deve ser exclusivo para um sistema.
DBName	string	Rótulo legível por humanos que identifica o banco de dados existente que contém a collection com um ou mais índices do Atlas Search. IMPORTANTE: o banco de dados de dados que você especifica já deve existir. Se você não tiver um banco de banco de dados existente, crie um.
collectionName	string	Rótulo legível por humanos que identifica a coleção que contém um ou mais índices do Atlas Search.
type	string	Tipo de índice. O Atlas aceita os seguintes valores: search vectorSearch
search	objeto	Você deve incluir este objeto se type for search. Caso contrário, omita.
vectorSearch	objeto	Você deve incluir este objeto se type for vectorSearch. Caso contrário, omita.

spec.deploymentSpec.searchIndexes.search

Tipo: objeto

Opcional

Campo	Tipo	Descrição
synonyms	array	Conjuntos de regras que mapeiam palavras em relação a seus sinônimos neste índice
mappings	objeto	Especificações de índice para os campos da collection Obrigatório
searchConfigurationRef	objeto	Uma referência de nome/namespace ao recurso personalizado AtlasSearchIndexConfig, descrito abaixo. Obrigatório

spec.deploymentSpec.searchIndexes.search.synonyms

Tipo: array

Opcional

Uma array de objetos Synonym com campos que descrevem conjuntos de regras que mapeiam palavras até seus sinônimos neste índice. Cada objeto Synonym contém os seguintes campos:

Campo	Tipo	Descrição
name	string	Rótulo legível por humanos que identifica a definição de sinônimo. Cada nome deve ser exclusivo dentro da mesma definição de índice Obrigatório
analyzer	string	Método pré-definido específico escolhido para aplicar aos sinônimos a serem pesquisados. Os valores possíveis são: lucene.standard 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 Obrigatório
source	objeto	Conjunto de dados que armazena o mapeamento de uma ou mais palavras para um ou mais sinônimos dessas palavras Obrigatório

spec.deploymentSpec.searchIndexes.search.synonyms.source

Tipo: objeto

Obrigatório

Campo	Tipo	Descrição
collection	string	Etiqueta legível por humanos que identifica a collection MongoDB que armazena palavras e seus sinônimos aplicáveis Obrigatório

spec.deploymentSpec.searchIndexes.search.mappings

Tipo: objeto

Obrigatório

Um objeto com especificações de Índice para os campos da coleção:

dynamic	booleano	Sinalizador que indica se o índice utiliza mapeamentos dinâmicos ou estáticos. Obrigatório se maps.fields for omitido.
fields	JSON/YAML	Uma ou mais especificações de campo para o índice do Atlas Search. Obrigatório se mapeamentos.dynamic for omitido ou definido como falso.

spec.deploymentSpec.searchIndexes.vectorSearch

Tipo: objeto

Opcional

Campo	Tipo	Descrição
fields	JSON/YAML	Array de objetos JSON. Consulte exemplos https://dochub.mongodb.org/core/avs-vector-type Obrigatório

spec.deploymentSpec.searchNodes

Tipo: array

Opcional

Uma array de configurações de nós do Atlas Search . Cada elemento contém dois campos:

Campo	Tipo	Descrição
nodeCount	inteiro	Número de nós do Atlas Search no cluster. O Atlas aceita valores de 2 a 32, inclusive. O número padrão é 2.
instanceSize	string	Especificação de hardware para os tamanhos de instância de nó do Atlas Search . O Atlas aceita uma das seguintes opções: S20_HIGHCPU_NVME S30_HIGHCPU_NVME S40_HIGHCPU_NVME S50_HIGHCPU_NVME S60_HIGHCPU_NVME S70_HIGHCPU_NVME S80_HIGHCPU_NVME S30_LOWCPU_NVME S40_LOWCPU_NVME S50_LOWCPU_NVME S60_LOWCPU_NVME S80_LOWCPU_NVME S90_LOWCPU_NVME S100_LOWCPU_NVME O tamanho da instância padrão é S20_HIGHCPU_NVME.

spec.deploymentSpec.tags

Tipo: array

Opcional

Lista que contém tags (pares chave-valor) para entender, organizar e identificar melhor seus sistemas de banco de dados. Para saber mais, consulte Tags em clusters.

spec.deploymentSpec.terminationProtectionEnabled

Tipo: booleano

Indica se a proteção de rescisão está habilitada ou desabilitada para seu cluster. Se configurado para true, o Atlas não excluirá o cluster. Se definido como false, o Atlas excluirá o cluster. O padrão é false.

spec.deploymentSpec.versionReleaseSystem

Tipo: string

Condicional

Cadência de liberação que o Atlas usa para esse cluster. Atlas aceita:

• CONTINUOUS: o Atlas cria seu cluster usando a versão mais recente do MongoDB. O Atlas atualiza automaticamente seu cluster para as versões principais e rápidas mais recentes do MongoDB à medida que elas são disponibilizadas.

• LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the spec.deploymentSpec.mongoDBMajorVersion parameter. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.

  Se omitido, o padrão é LTS.

  If you set this parameter to CONTINUOUS, you must omit the spec.deploymentSpec.mongoDBMajorVersion parameter.

spec.externalProjectRef.id

Tipo: string

Condicional

ID do projeto ao qual pertence o sistema. Você deve especificar o ID do projeto de um Atlas Project existente. Esse parâmetro é necessário para implantações que pertencem a projetos gerenciados por:

• Uma instância diferente do Atlas Kubernetes Operator

• Ferramentas diferentes do Atlas Kubernetes Operator

Para implantações que pertencem a projetos gerenciados pela mesma instância do Atlas Kubernetes Operator, utilize spec.projectRef.name se você não utilizar spec.externalProjectRef.id.

spec.flexSpec

Tipo: array

Condicional

Observação

Consulte Notas sobre transição para clusters flexíveis para obter informações completas sobre alterações.

List that contains the Flex cluster parameters from the API. For a full list of available parameters, see the Atlas Flex Clusters API.

Importante

You must specify spec.deploymentSpec or spec.flexSpec in your configuration.

spec.flexSpec.name

Tipo: string

string que identifica o nome do Flex cluster.

spec.flexSpec.tags

Tipo: array

Opcional

Lista que contém tags (pares chave-valor) para entender, organizar e identificar melhor seus sistemas de banco de dados. Para saber mais, consulte Tags em clusters.

spec.flexSpec.terminationProtectionEnabled

Tipo: booleano

Indica se a proteção de rescisão está habilitada ou desabilitada para seu cluster Flex. Se configurado para true, o Atlas não excluirá o cluster. Se definido como false, o Atlas excluirá o cluster. O padrão é false.

spec.flexSpec.providerSettings.backingProviderName

Tipo: string

O nome do provedor de nuvem para seu cluster Flex. providerSettings inclui a configuração que especifica as configurações para os hosts provisionados nos quais o MongoDB é executado.

O Atlas aceita um dos seguintes valores:

• AWS

• AZURE

• GCP

spec.flexSpec.providerSettings.regionName

Tipo: string

Localização física do cluster MongoDB Flex. A região escolhida pode afetar a latência da rede para os clientes que acessam seus bancos de dados.

Para obter uma lista completa dos valores de nome de região, consulte as páginas de referência do fornecedor de serviços em nuvem:

• AWS

• GCP

• Azure

spec.processArgs

Tipo: objeto

Opcional

Object that contains the additional configuration options for your cluster.

spec.processArgs.defaultReadConcern

Tipo: string

Opcional

string que indica o nível padrão de confirmação solicitado do MongoDB para operações de leitura definidas para o cluster.

Os clusters MongoDB 5.0 são padronizados como locais.

spec.processArgs.defaultWriteConcern

Tipo: string

Opcional

String that indicates the default level of acknowledgment requested from MongoDB for write operations set for this cluster.

MongoDB versions 5.0 and later clusters default to majority.

spec.processArgs.failIndexKeyTooLong

Tipo: booleano

Opcional

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.

This option corresponds to the param.failIndexKeyTooLong mongod parameter.

spec.processArgs.javascriptEnabled

Tipo: booleano

Opcional

Flag que indica se o cluster permite a execução de operações que realizam execuções em JavaScript no lado do servidor.

• This option corresponds to modifying the security.javascriptEnabled configuration file option for each mongod and mongos in the cluster.

spec.processArgs.minimumEnabledTlsProtocol

Tipo: inteiro

Opcional

String que indica a versão mínima de TLS que o cluster aceita para conexões de entrada. Para clusters que usam TLS 1.0 ou 1.1, recomendamos definir o TLS 1.2 como a versão mínima do protocolo TLS.

Para saber mais, consulte Quais versões do TLS o Atlas suporta?.

This option corresponds to the net.ssl.disabledProtocols mongod configuration file option.

spec.processArgs.noTableScan

Tipo: booleano

Opcional

Flag que indica se o cluster desativa a execução de qualquer query que exija uma varredura de coleção para retornar resultados.

This option corresponds to the notablescan mongod parameter.

spec.processArgs.oplogSizeMB

Tipo: inteiro

Opcional

Número que indica o limite de armazenamento do oplog de um cluster expresso em megabytes. Um valor de null indica que o agrupamento utiliza o tamanho de oplog padrão que o Atlas calcula.

This option corresponds to the replication.oplogSizeMB mongod configuration file option.

spec.processArgs.sampleRefreshIntervalBIConnector

Tipo: inteiro

Opcional

Número que indica os documentos por banco de dados a serem amostrados ao coletar informações do esquema.

Este parâmetro corresponde à opção sampleSize mongosqld .

spec.processArgs.sampleSizeBIConnector

Tipo: inteiro

Opcional

Número que indica o intervalo, em segundos, no qual o processo mongosqld faz uma nova amostra dos dados para criar seu esquema relacional.

This parameter corresponds to the sampleRefreshIntervalSecs mongosqld option.

spec.projectRef.name

Tipo: string

Condicional

Nome do projeto ao qual o sistema pertence. Você deve especificar um AtlasProject Recurso Personalizado existente. Este parâmetro se aplica somente a sistemas que pertencem a projetos gerenciados pela mesma instância do Atlas Kubernetes Operator.

Para implementações que pertencem a projetos gerenciados por:

• uma instância diferente do Atlas Kubernetes Operator

• ferramentas diferentes do Atlas Kubernetes Operator

usar spec.externalProjectRef.id.

spec.serverlessSpec

Tipo: array

Condicional

Observação

Consulte Notas sobre transição para clusters flexíveis para obter informações completas sobre alterações.

Lista que contém os parâmetros da instância sem servidor da API. Para obter uma lista completa dos parâmetros disponíveis, consulte a APIdo Atlas Flex Clusters.

Importante

Você deve especificar spec.deploymentSpec ou spec.flexSpec em sua configuração.

spec.upgradeToDedicated

Tipo: booleano

Opcional

Sinalizador que, quando definido como true, aciona uma atualização no local de um cluster flexível para um cluster dedicado.

Se omitido, o padrão é false. Para obter uma passo a passo completo do processo de migração, consulte Migrar um cluster Flex para um cluster Dedicado.

Importante

Você também deve fornecer a configuração completa do cluster dedicado de destino no bloco spec.deploymentSpec. Esta operação é unidirecional e irreversível.

spec.serverlessSpec.privateEndpoints

Tipo: array

Opcional

Observação

O Atlas desativou os clusters M2 e M5 e as instâncias sem servidor. O Atlas migrou todos os clusters M2 e M5 para clusters Flex. Para instâncias sem servidor, o Atlas migrou instâncias para clusters gratuitos, clusters flexíveis ou clusters dedicados de acordo com seu uso.

Para preservar a compatibilidade com versões anteriores das APIs por um período de tempo, o Atlas continuará permitindo que esses clusters migrados sejam gerenciados por meio das mesmas APIs (antigas e novas APIs), inclusive ao usar o Atlas Kubernetes Operator. A compatibilidade com versões anteriores das APIs permanecerá em vigor até 2026 de janeiro, quando as APIs antigas serão removidas e apenas as APIs relacionadas a clusters Flex permanecerão em vigor.

O suporte para pontos de extremidade privados em instâncias sem servidor terminou em 2025 de março. Você deve atualizar suas configurações do Atlas Kubernetes Operator para remover pontos de extremidade privados até março de 2025. Você deve remover todos os recursos restantes das instâncias M2, M5 e sem servidor das configurações do Atlas Kubernetes Operator antes de janeiro de 2026.

If your workloads require Private Endpoints or Continuous Backup, switch to Atlas Dedicated Clusters. To learn more, see Migration to Flex Clusters and the Atlas Flex Migration Guide.

Obsoleto. Remova este parâmetro se ele existir. Lista que contém as configurações de endpoint privado para a instância sem servidor.

spec.serverlessSpec.providerSettings

Tipo: objeto

Condicional

Observação

Consulte Notas sobre transição para clusters flexíveis para obter informações completas sobre alterações.

Configuração que especifica as configurações para os hosts provisionados nos quais o MongoDB é executado. As opções disponíveis são específicas para o provedor de serviços de nuvem. Para saber mais, consulte as opções de configuração de instância do Amazon Web Services, GCP e Azure Serverless.

Se você deseja criar ou atualizar uma instância sem servidor, especifique esta configuração.

Importante

As seguintes configurações são preteridas e serão removidas em uma versão futura:

• spec.serverlessSpec.providerSettings.DiskIOPS

• spec.serverlessSpec.providerSettings.DiskTypeName

• spec.serverlessSpec.providerSettings.EncryptEBSVolume

• spec.serverlessSpec.providerSettings.InstanceSizeName

• spec.serverlessSpec.providerSettings.VolumeType

• spec.serverlessSpec.providerSettings.AutoScaling

Fornecer valores para qualquer uma dessas configurações não tem efeito.

spec.serverlessSpec.providerSettings.providerName

Tipo: string

Condicional

Observação

Consulte Notas sobre transição para clusters flexíveis para obter informações completas sobre alterações.

Provedor de serviços de nuvem no qual o Atlas provisiona o host para uma instância sem servidor.

O Atlas aceita os seguintes valores:

AWS	Amazon AWS
GCP	Google Cloud Platform
AZURE	Microsoft Azure

spec.serverlessSpec.providerSettings.regionName

Tipo: string

Condicional

Observação

Consulte Notas sobre transição para clusters flexíveis para obter informações completas sobre alterações.

Localização física da sua instância sem servidor MongoDB. A região que você escolhe pode afetar a latência de rede para clientes que acessam os bancos de dados.

Para obter uma lista completa dos valores de nome de região, consulte as páginas de referência do fornecedor de serviços em nuvem:

• AWS

• GCP

• Azure

spec.serverlessSpec.tags

Observação

Consulte Notas sobre transição para clusters flexíveis para obter informações completas sobre alterações.

Tipo: array

Opcional

Lista que contém tags (pares chave-valor) para entender, organizar e identificar melhor seus sistemas de banco de dados. Para saber mais, consulte Tags em clusters.

status.connectionStrings

Tipo: array

Obrigatório

Lista que contém as URLs de conexão para acessar o cluster. Esse parâmetro aparece depois que você cria ou atualiza um cluster.

Observação

.. include:: /includes/fact-ek8so-connection-strings.rst

Para obter os parâmetros de configuração disponíveis para um cluster a partir da API, consulte API do Atlas Clusters.