Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs
Página inicial do Docs
/ /
Recursos personalizados
Página inicial do Docs
/
Gestão
/
Atlas Kubernetes Operator
/
Recursos personalizados
Página inicial do Docs
/
Gestão
/
Atlas Kubernetes Operator
/
Recursos personalizados

AtlasNetworkContainer Recurso personalizado

Importante

Os subrecursos legados são preteridos a partir do lançamento de seus CRDs correspondentes. Se sua configuração depender atualmente da forma de subrecurso dessa definição de recurso, migre para um CRD.

O recurso personalizado do AtlasNetworkContainer define um contêiner de rede para um projeto Atlas. Você cria conexões de peering de VPC entre os containers de rede e as redes que hospedam seus aplicativos.

Importante

Os Recursos Personalizados Não Excluem Mais Objetos por Padrão

  • O Atlas Kubernetes Operator utiliza arquivos de configuração de recurso personalizado para gerenciar sua configuração do Atlas , mas a partir do Atlas Kubernetes Operator,2.0 os recursos personalizados que você exclui no Kubernetes não são mais (por padrão) excluídos no Atlas. Em vez disso, o Atlas Kubernetes Operator simplesmente para de gerenciar estes recursos no Atlas. Por exemplo, se você excluir um AtlasProject Recurso Personalizado no Kubernetes, por padrão, o Atlas Kubernetes Operator não excluirá mais automaticamente o projeto correspondente do Atlas. Essa mudança no comportamento destina-se a ajudar a evitar exclusões acidentais ou inesperadas. Para saber mais, incluindo como reverter este comportamento para o padrão utilizado antes do Atlas Kubernetes Operator.,2 0consulte Novo padrão: Proteção de exclusão no Atlas Kubernetes 2 0Operator..

    Da mesma forma, o Atlas Kubernetes Operator não exclui equipes do Atlas se você as remover de um projeto do Atlas no Kubernetes com o Atlas Kubernetes Operator.

  • Defina explicitamente os detalhes de configuração desejados para evitar o uso implícito de valores de configuração padrão do Atlas . Em alguns casos, herdar os padrões do Atlas pode resultar em um loop de reconciliação que pode impedir que seu recurso personalizado atinja um estado READY. Por exemplo, definir explicitamente o comportamento de autoscaling desejado em seu recurso personalizado AtlasDeployment, conforme mostrado no exemplo incluído, garante que um tamanho de instância estática em seu recurso personalizado não esteja sendo aplicado repetidamente a um sistema do Atlas que tenha o autoscaling ativado.

    autoScaling:
      diskGB:
        enabled: true
      compute:
        enabled: true
        scaleDownEnabled: true
        minInstanceSize: M30
        maxInstanceSize: M40

Atlas Kubernetes Operator does one of the following actions using the Atlas Network Peering API Resource:

  • Cria um novo container de rede.

  • Atualiza um container de rede existente.

Exemplos

Os exemplos a seguir ilustram configurações para CRDs do AtlasNetworkContainer.

  • A configuração básica de exemplo define um recurso que você gerencia com a mesma instância do Atlas Kubernetes Operator com a qual você gerencia seu projeto pai do Atlas .

  • O exemplo de CRD independente configura o mesmo container de rede que o exemplo básico, mas para um projeto do Atlas que você gerencia fora da instância do Atlas Kubernetes Operator com a qual você gerencia o container de rede.

Exemplo básico

O seguinte mostra um recurso personalizado AtlasNetworkContainer para um contêiner chamado my-atlas-nc que permite criar uma conexão de emparelhamento de VPC entre o Atlas e a AWS no projeto my-project. Para gerenciar este recurso na mesma instância do Atlas Kubernetes Operator que seu projeto Atlas pai, você deve identificar o projeto com projectRef em vez de externalProjectRef.

apiVersion: atlas.mongodb.com/v1
kind: AtlasNetworkContainer
metadata:
  name: my-atlas-nc
spec:
  projectRef:
    name: my-project
    namespace: my-operator-namespace
  provider: AWS
  id: 66e2f2b7e69a89b66b621571
  cidrBlock: 10.11.0.0/16
  region: US_EAST_1

Exemplo de CRD independente

The following example shows an AtlasNetworkContainer independent CRD that enables VPC peering under the same parameters enabled by the Basic Example. To enable independent operation, you must use an externalProjectRef instead of a projectRef, and you must supply a connectionSecret directly since this resource can't inherit API credentials from its parent project.

apiVersion: atlas.mongodb.com/v1
kind: AtlasNetworkContainer
metadata:
  name: my-atlas-nc
spec:
  externalProjectRef:
    projectId: 66e2f2b621571b7e69a89b66
  connectionSecret:
    name: atlas-connection-secret
  provider: AWS
  id: 66e2f2b7e69a89b66b621571
  cidrBlock: 10.11.0.0/16
  region: US_EAST_1

Parâmetros

AtlasNetworkContainer

AtlasNetworkContainer é o esquema para a API AtlasNetworkContainer

Name
Tipo
Descrição
Obrigatório

apiVersion

string

atlas.mongodb.com/v1

true

kind

string

AtlasNetworkContainer

true

metadata

objeto

Consulte a documentação do Kubernetes API para os campos do campo metadata.

true

spec

objeto

AtlasNetworkContainerSpec define o estado alvo de um AtlasNetworkContainer. validação:

  • (has(auto.''externalProjectRef'') && !has(auto.''projectRef'')) || (!has(auto.''externalProjectRef'') && has(auto.``projectRef``)): deve definir apenas uma referência do projeto por meio de externalProjectRef ou projectRef

  • (has(auto.''externalProjectRef'') && has(auto.``connectionSecret``)) || !has(auto.''externalProjectRef''): deve definir um segredo de conexão local ao fazer referência a um projeto externo

  • (auto.provider == 'GCP' && !has(auto.region)) || (self.provedor != 'GCP'): não deve definir região para contêineres GCP

  • ((self.provedor == 'AWS' || self.provedor == 'AZURE') && has(self.região)) || (auto.provider == 'GCP'): deve definir a região para AWS e contêineres do Azure

  • (auto.id == oldSelf.id) || (!has(auto.id) && !has(oldSelf.id)): id é imutável

  • (self.região == oldSelf.região) || (!has(self.região) && !has(oldSelf.region)): região é imutável

false

status

objeto

AtlasNetworkContainerStatus é um status para o recurso Personalizado AtlasNetworkContainer. Não aquele incluído no AtlasProject

false

AtlasNetworkContainer.spec

AtlasNetworkContainerSpec define o estado de destino de um AtlasNetworkContainer.

Name
Tipo
Descrição
Obrigatório

provider

enum

Provedor é o nome da nuvem provider que hospeda o contêiner de rede. enumeração: AWS, GCP, AZURE

true

cidrBlock

string

Atlas CIDR. Precisa ser definido se ContainerID não estiver definido.

false

connectionSecret

objeto

Nome do segredo contendo as chaves privada e pública do Atlas API.

false

externalProjectRef

objeto

externalProjectRef contém o projeto principal do Atlas ID. Mutualmente exclusivo com o campo"projectRef".

false

id

string

ID é o identificador de contêiner para um contêiner de rede já existente a ser gerenciado pelo operador. Este campo pode ser utilizado em conjunto com cidrBlock para atualizar o cidrBlock de um contêiner existente. Este campo é imutável.

false

projectRef

objeto

projectRef é uma referência ao recurso pai AtlasProject. Mutualmente exclusivo com o campo"externalProjectRef".

false

region

string

ContainerRegion é o nome do provedor region do contêiner de emparelhamento Atlas no formato Atlas region Exigido pelo AWS e pelo Azure, mas não usado pelo GCP. Este campo é imutável, o Atlas não permite alterações no contêiner de rede.

false

AtlasNetworkContainer.spec.connectionSecret

Nome do segredo que contém as chaves privadas e públicas da Atlas API.

Name
Tipo
Descrição
Obrigatório

name

string

Nome do recurso que está sendo referenciado Mais informações: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

true

AtlasNetworkContainer.spec.externalProjectRef

externalProjectRef contém o ID do grupo pai do Atlas. Mutualmente exclusivo com o campo"projectRef".

Name
Tipo
Descrição
Obrigatório

id

string

ID é o projeto Atlas ID.

true

AtlasNetworkContainer.spec.projectRef

projectRef é uma referência ao recurso pai AtlasProject. Mutualmente exclusivo com o campo"externalProjectRef".

Name
Tipo
Descrição
Obrigatório

name

string

Nome do Recurso Kubernetes

true

namespace

string

Namespace do Recurso Kubernetes

false

AtlasNetworkContainer.status

AtlasNetworkContainerStatus é um status para o recurso AtlasNetworkContainer Custom. Não aquele incluído no AtlasProject

Name
Tipo
Descrição
Obrigatório

conditions

[] objeto

Condições é a lista de status que mostra o estado atual do Recurso Personalizado do Atlas

true

id

string

ID fazer o registro do identificador do contêiner no Atlas

false

observedGeneration

inteiro

ObservedGeneration indica a geração da especificação de recurso da qual o Operador Atlas está ciente. O Operador do Atlas atualiza este campo para o valor de 'metadados.generation' assim que iniciar a reconciliação do recurso. Formato: int64

false

provisioned

booleano

O provisionamento é verdadeiro quando clusters tiverem sido implantados no contêiner antes da última reconciliação

false

AtlasNetworkContainer.status. conditions

A condição descreve o estado de um recurso personalizado do Atlas em um determinado ponto.

Name
Tipo
Descrição
Obrigatório

status

string

Status da condição; um de verdadeiro, falso, desconhecido.

true

type

string

Tipo de condição do Atlas recurso.

true

lastTransitionTime

string

Última vez que a condição fez a transição de um status para outro. Representado no formato ISO 8601. Formato: data/hora

false

message

string

Um message fornecendo detalhes sobre a transição.

false

reason

string

O reason para a última transição da condição.

false

Próximo
Começar
Avalie esta página

Nesta página