AtlasDeployment Recurso personalizado

Exemplos

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  namespace: default
  labels:
    app.kubernetes.io/version: 1.6.0
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    name: test-cluster
    tags:
    - key: "environment",
      value: "production"
    providerSettings:
      instanceSizeName: M10
      providerName: AWS
      regionName: US_EAST_1
    mongoDBMajorVersion: "4.4"
status:
  conditions:
  - lastTransitionTime: "2021-03-18T16:32:43Z"
    status: "True"
    type: Ready
  - lastTransitionTime: "2021-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: 4.4.4
  mongoURIUpdated: "2021-03-12T12:21:41Z"
  observedGeneration: 1
  stateName: IDLE

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
  name: test-cluster-name
  namespace: mongodb-atlas-system
spec:
  projectRef:
    name: development
  deploymentSpec:
    autoScaling:
      compute:
        enabled: true
        scaleDownEnabled: true
    clusterType: REPLICASET
    name: service-name
    tags:
    - key: "environment",
      value: "production"
    providerBackupEnabled: true
    providerSettings:
      autoScaling:
        compute:
          maxInstanceSize: M40
          minInstanceSize: M30
      instanceSizeName: M30
      providerName: GCP
    replicationSpecs:
      - numShards: 1
        regionsConfig:
          EASTERN_US:
            analyticsNodes: 0
            electableNodes: 1
            priority: 6
            readOnlyNodes: 0
          SOUTH_AMERICA_EAST_1:
            analyticsNodes: 0
            electableNodes: 2
            priority: 7
            readOnlyNodes: 0
        zoneName: Zone 1

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  labels:
    app.kubernetes.io/version: 1.6.0
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    name: Test-cluster
    tags:
    - key: "environment",
      value: "production"
    providerSettings:
      instanceSizeName: M10
      providerName: AWS
      regionName: US_EAST_1
  processArgs:
    javascriptEnabled: false

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: test-cluster-name
  namespace: mongodb-atlas-system
  labels:
    app.kubernetes.io/version: 1.6.0
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
  labels:
    app.kubernetes.io/version: 1.6.0
spec:
  projectRef:
    name: my-project
  advancedDeploymentSpec:
    clusterType: REPLICASET
    name: tenantCluster
    tags:
    - key: "environment",
      value: "production"
    replicationSpecs:
      - regionConfigs:
        - electableSpecs:
            instanceSize: M5
          providerName: AWS
          regionName: US_EAST_1

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  labels:
    app.kubernetes.io/version: 1.6.0
spec:
  projectRef:
    name: my-project
  advancedDeploymentSpec:
    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

Parâmetros

Esta seção descreve alguns dos principais parâmetros de recursos personalizados AtlasDeployment disponíveis. Para obter uma lista completa dos parâmetros disponíveis para clusters, consulte a API de Clusters do Atlas e a API de Clusters Avançados do Atlas . Para obter uma lista completa dos parâmetros disponíveis para instâncias sem servidor, consulte a API Atlas Instâncias sem Servidor API.

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

spec.advancedDeploymentSpec

Tipo: array

Condicional

Lista que contém os parâmetros avançados do cluster da API. Para obter uma lista completa dos parâmetros disponíveis, consulte a API Atlas Advanced Clusters.

Importante

Você deve especificar spec.deploymentSpec, spec.advancedDeploymentSpec ou spec.serverlessSpec em sua configuração.

spec.advancedDeploymentSpec.customZoneMapping

Tipo: array

Obrigatório

Lista que contém parâmetros do Cluster Global que mapeia zonas para regiões geográficas. Para obter uma lista completa dos parâmetros disponíveis, consulte a Atlas API Clusters.

spec.advancedDeploymentSpec.customZoneMapping.location

Tipo: string

Obrigatório

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

spec.advancedDeploymentSpec.customZoneMapping.zone

Tipo: string

Obrigatório

Etiqueta legível para humanos que identifica a zona em seu cluster global.

spec.advancedDeploymentSpec.diskSizeGB

Tipo: número

Opcional

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

Não é possível definir esse valor com clusters com SSDs NVMe locais.

Observação

Se você tiver o autoscaling habilitado para diskGB em qualquer região, não poderá editar esta opção. Para saber mais, consulte spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabled.

O tamanho mínimo do disco para clusters dedicados é 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 o comando de banco de dados incluir nós Azure, esse valor deverá 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.

O Atlas tem limites de capacidade de disco em conjuntos de réplicas únicas, podendo escalar até 4 TB para camadas de cluster mais altas. Para expandir o armazenamento total do cluster além dos limites padrão, você pode habilitar o armazenamento estendido nas Configurações do projeto. Para acomodar maior escalabilidade no futuro, recomendamos que você habilite a fragmentação para expansão de longo prazo.

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.

Para saber mais, consulte Capacidade de armazenamento.

spec.advancedDeploymentSpec.managedNamespaces

Tipo: array

Obrigatório

Lista que contém informações para criar um namespace gerenciado em um cluster global especificado a ser criado. Para obter uma lista completa dos parâmetros disponíveis, consulte a Atlas API Clusters.

spec.advancedDeploymentSpec.managedNamespaces.collection

Tipo: string

Obrigatório

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

spec.advancedDeploymentSpec.managedNamespaces.db

Tipo: string

Obrigatório

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

spec.advancedDeploymentSpec.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.

• Defina como false para desativar uma chave de shard personalizada para a coleção. Se diabled, o MongoDB usa sharding à distância.

Para saber mais, consulte Hashed Shard Keys.

spec.advancedDeploymentSpec.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.advancedDeploymentSpec.managedNamespaces.numInitialChunks

Tipo: inteiro

Opcional

Número mínimo de chunks a serem criados inicialmente ao fragmentar uma coleção vazia com uma chave fragmentada com hash.

Para saber mais, consulte Shard a Global Collection.

spec.advancedDeploymentSpec.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.advancedDeploymentSpec.pitEnabled

Tipo: booleano

Condicional

Configuração que habilita o backup em nuvem contínuo para clusters avançados. Para habilitar o backup em nuvem contínuo, você deve especificar esta configuração com um valor de true. Para clusters padrão, consulte spec.deploymentSpec.pitEnabled.

spec.advancedDeploymentSpec.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 M5` clusters require only ``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.advancedDeploymentSpec.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 leitura e nunca podem se tornar o :primary.

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

spec.advancedDeploymentSpec.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.

A quantidade máxima de RAM para a camada do cluster selecionada e o tamanho do oplog podem limitar o auto-scaling de armazenamento. Para saber mais, consulte Personalizar seu armazenamento.

spec.advancedDeploymentSpec.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.

• Defina como true para habilitar o auto-scaling do tamanho da instância. Se habilitado, você deve especificar um valor para spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize.

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

spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize

Tipo: string

Condicional

string que indica o tamanho máximo da instância para a qual o sistema de banco de dados pode ser dimensionado automaticamente (como M40). Você deve especificar este parâmetro se você configurar o spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled para true.

Observação

Se você definir um tamanho máximo de instância menor que o tamanho de instância atual do comando de banco de dados com o autoscaling ativado, o Atlas dimensionará automaticamente o tamanho atual da instância 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.

Se o Atlas alterar o tamanho da instância atual e você não alterar o spec.deploymentSpec.providerSettings.instanceSizeName no Atlas Kubernetes Operator para corresponder ao novo tamanho da instância, o Atlas Kubernetes Operator exibirá um aviso nos registros, mas não impedirá o escalonamento automático.

spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize

Tipo: string

Condicional

string que indica o tamanho mínimo da instância para a qual o sistema de banco de dados pode ser dimensionado automaticamente (como M10). Você deve especificar este parâmetro se você configurar o spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled para true.

Observação

Se você definir um tamanho mínimo de instância maior que o tamanho de instância atual do comando de banco de dados com o autoscaling ativado, o Atlas dimensionará automaticamente o tamanho atual da instância 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.

Se o Atlas alterar o tamanho da instância atual e você não alterar o spec.deploymentSpec.providerSettings.instanceSizeName no Atlas Kubernetes Operator para corresponder ao novo tamanho da instância, o Atlas Kubernetes Operator exibirá um aviso nos registros, mas não impedirá o escalonamento automático.

spec.advancedDeploymentSpec.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.advancedDeploymentSpec.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 .

Se você implantar um : cluster fragmentado ou cluster global, você deverá escolher um tamanho de instância de M30 ou superior.

Observação

Se você tiver o autoscaling habilitado para o campo de computação, não poderá editar esta opção. Para saber mais, consulte spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled.

spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.electableSpecs.nodeCount

Tipo: inteiro

Condicional

Número de nós elegíveis para implantação do Atlas 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 .

Não é possível criar nós elegíveis se spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.priority for 0.

spec.advancedDeploymentSpec.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ó :primary na Região preferencial. As prioridades 1 a 7 são exclusivas: você não pode 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.advancedDeploymentSpec.replicationSpecs.regionConfigs.readOnlySpecs

Tipo: objeto

Opcional

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

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

spec.advancedDeploymentSpec.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 Marcações em clusters.

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ê não especificar este parâmetro, o Atlas não aplicará sua configuração de backup 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.deploymentSpec

Tipo: array

Condicional

Lista que contém os parâmetros do cluster da API. Para obter uma lista completa dos parâmetros disponíveis, consulte a APIdo Atlas API.

Importante

Você deve especificar spec.deploymentSpec, spec.advancedDeploymentSpec ou spec.serverlessSpec em sua configuração.

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
Você spec.deploymentSpec.replicationSpecs define.	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

Lista que contém parâmetros do Cluster Global que mapeia zonas para regiões geográficas. Para obter uma lista completa dos parâmetros disponíveis, consulte a Atlas API Clusters.

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

Etiqueta legível para humanos que identifica a zona em seu cluster global.

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

Lista que contém informações para criar um namespace gerenciado em um cluster global especificado a ser criado. Para obter uma lista completa dos parâmetros disponíveis, consulte a Atlas API Clusters.

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.

• Defina como false para desativar uma chave de shard personalizada para a coleção. Se diabled, o MongoDB usa sharding à distância.

Para saber mais, consulte 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

Número mínimo de chunks a serem criados inicialmente ao fragmentar uma coleção vazia com uma chave fragmentada com hash.

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+ :

• 4.4

• 5.0

• 6.0

• 7.0

• 8.0

As seguintes condições produzem os seguintes resultados:

Condição	Resultado
Você omite este parâmetro e omite o spec.deploymentSpec.versionReleaseSystem parâmetro.	O Atlas implementa um cluster que executa o MongoDB 6,0.
Você omite este parâmetro e define o spec.deploymentSpec.versionReleaseSystem parâmetro LTS como.	O Atlas implementa um cluster que executa o MongoDB 6,0.
Você define o spec.deploymentSpec.providerSettings.instanceSizeName parâmetro M0 M2como,M5 ou.	Você deve distribuir o MongoDB 6.0.
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.
Você define o spec.deploymentSpec.versionReleaseSystem parâmetro CONTINUOUS como.	Você deve omitir este parâmetro.

spec.deploymentSpec.pitEnabled

Tipo: booleano

Condicional

Configuração que habilita o backup em nuvem contínuo. Para habilitar o backup em nuvem contínuo, você deve especificar esta configuração com um valor de true. Para clusters avançados, consulte spec.advancedDeploymentSpec.pitEnabled.

spec.deploymentSpec.providerSettings

Tipo: objeto

Condicional

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 cluster da Amazon Web Services, GCP e Azure .

Se você deseja criar ou atualizar um cluster, especifique esta configuração.

spec.deploymentSpec.providerSettings.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.providerSettings.instanceSizeName

Tipo: string

Obrigatório

O Atlas oferece diferentes camadas do cluster, cada uma com uma capacidade de armazenamento e um tamanho de RAM padrão. O cluster selecionado é usado para todos os servidores portadores de dados em seu cluster. Para saber mais, consulte os tamanhos de armazenamento personalizados da Amazon Web Services, GCP e Azure .

Se você alterar o nome do tamanho da instância após distribuir o cluster, o Atlas alterará o sistema de banco de dados para o tamanho da instância especificado, a menos que ele esteja fora do intervalo especificado em spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize e spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize com o dimensionamento automático ativado. Para saber mais, consulte spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize e spec.advancedDeploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize.

Observação

Você pode alterar essa configuração para atualizar um cluster M0, M2 ou M5 para um cluster M10+ . No entanto, você não pode atualizar um cluster M0, M2 ou M5 para outro cluster compartilhado ou gratuito. Por exemplo, você não pode atualizar um cluster M0 para um cluster M5 .

spec.deploymentSpec.providerSettings.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

Para agrupamentos de múltiplas regiões, consulte spec.deploymentSpec.replicationSpecs. Você deve definir spec.deploymentSpec.providerSettings.regionName ou spec.deploymentSpec.replicationSpecs.

spec.deploymentSpec.replicationSpecs

Tipo : array de objetos

Condicional

Lista que contém as configurações para suas regiões de cluster. Use esse parâmetro para clusters multirregionais. Você deve definir spec.deploymentSpec.providerSettings.regionName ou 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.

Se você especificar este parâmetro, você também deverá especificar spec.deploymentSpec.clusterType e 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.

Se você utilizar o parâmetro spec.deploymentSpec.replicationSpecs , você deverá configurar este parâmetro.

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

• Se você especificar um valor de 1 e definir spec.deploymentSpec.clusterType como SHARDED, o Atlas implantará um cluster fragmentado fragmentado de fragmento único.

• Se você especificar 1 e configurar spec.deploymentSpec.clusterType para REPLICASET, o Atlas implantará um conjunto de réplicas.

  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

spec.deploymentSpec.replicationSpecs.zoneName

Tipo: string

Opcional

Rótulo legível por humanos que identifica a zona em um cluster global. Forneça esse valor somente se você definir spec.deploymentSpec.clusterType como GEOSHARDED.

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 Marcações em clusters.

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: o Atlas cria seu cluster usando a versão de patch mais recente da versão MongoDB que você especifica no parâmetro spec.deploymentSpec.mongoDBMajorVersion . O Atlas atualiza automaticamente seu cluster para versões de patch subsequentes desta versão do MongoDB. O Atlas não atualiza seu cluster para as versões rápidas ou principais mais recentes do MongoDB à medida que elas são disponibilizadas.

  Se omitido, o padrão é LTS.

  Se você definir este parâmetro como CONTINUOUS, deverá omitir o parâmetro spec.deploymentSpec.mongoDBMajorVersion .

spec.processArgs

Tipo: objeto

Opcional

Objeto que contém as opções de configuração avançadas para o seu 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 do MongoDB 4.4 têm como padrão disponível.

Os clusters MongoDB 5.0 são padronizados como locais.

spec.processArgs.defaultWriteConcern

Tipo: string

Opcional

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

Os clusters MongoDB 4.4 são padronizados como 1.

As versões 5.0 e posteriores dos clusters do MongoDB são padronizadas como maioria.

spec.processArgs.failIndexKeyTooLong

Tipo: booleano

Opcional

Sinalizador que indica se a operação deve falhar e retornar um erro ao inserir ou atualizar documentos em que todas as entradas indexadas excedam 1024 bytes. Se você definir isso como false, mongod gravará documentos que excederem esse limite, mas não os indexará.

Esta opção corresponde ao parâmetro param.failIndexKeyTooLong mongod .

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.

• Se o seu cluster executar uma versão do MongoDB inferior à 4.4, essa opção corresponderá à modificação da opção do arquivo de configuração security.javascriptEnabled para cada mongod no cluster.

• Se o seu cluster executar o MongoDB versão 4.4 ou posterior, essa opção corresponderá à modificação da opção do arquivo de configuração security.javascriptEnabled para cada mongod e mongos no 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. Os clusters que usam TLS 1.0 ou 1.1 devem considerar a configuração do TLS 1.2 como a versão mínima do protocolo TLS .

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

Esta opção corresponde à opção de arquivo de configuração do net.ssl.disabledProtocols mongod .

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.

Esta opção corresponde ao parâmetro notablescan mongod .

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.

Esta opção corresponde à opção de arquivo de configuração do replication.oplogSizeMB mongod .

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.

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

spec.projectRef.name

Tipo: string

Obrigatório

Nome do projeto ao qual o cluster pertence. Você deve especificar um Recurso PersonalizadoAtlasProject existente.

spec.serverlessSpec

Tipo: array

Condicional

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

Importante

Você deve especificar spec.deploymentSpec, spec.advancedDeploymentSpec ou spec.serverlessSpec em sua configuração.

spec.serverlessSpec.privateEndpoints

Tipo: array

Opcional

Lista que contém as configurações de endpoints privados para a instância sem servidor.

spec.serverlessSpec.providerSettings

Tipo: objeto

Condicional

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 da Amazon Web Services, GCP e instância sem servidor Azure .

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

spec.serverlessSpec.providerSettings.providerName

Tipo: string

Condicional

Fornecedor 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

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

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 Marcações 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

Você não pode usar um URL de conexão diretamente. Os Atlas clusters exigem autenticação. Você deve criar pelo menos um AtlasDatabaseUser Recurso Personalizado antes que o aplicação no seu cluster do Kubernetes possa se conectar ao cluster do Atlas. O Atlas Kubernetes Operator cria um secreto especial para cada combinação de cluster e usuário de banco de dados no projeto. A aplicação em seu cluster do Kubernetes pode usar esse segredo para se conectar ao cluster do Atlas. O parâmetro spec.scopes no recurso personalizado AtlasDatabaseUser restringe os clusters que criam o usuário de banco de dados.

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