/ /

`AtlasNetworkPeering` 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 AtlasNetworkPeering define uma conexão de peering de rede para um projeto do Atlas. As conexões de peering de rede isolam o tráfego de redes públicas para aumentar a segurança.

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 uma nova conexão de peering de rede.
Atualiza uma conexão de peering de rede existente.

Observação

Uma conexão de peering de rede pode pertencer somente a um projeto. Para definir a mesma conexão de peering de rede para vários projetos, crie definições de recursos personalizadas para cada projeto.

Exemplos

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

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 CRD independente configura a mesma conexão de emparelhamento de VPC 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 a conexão de emparelhamento de VPC.

Exemplo básico

O exemplo a seguir mostra um recurso personalizado AtlasNetworkPeering que define a conexão green-leaf-peering entre o projeto my-project VPC e sua AWS VPC. 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: AtlasNetworkPeering
metadata:
  name: green-leaf-peering
spec:
  projectRef:
    name: my-project
    namespace: my-operator-namespace
  containerRef:
    id: 72a6d2a69388ba121943ae27
  id: 72a6d2a69388ba121943ae27
  provider: AWS
  awsConfiguration:
    accepterRegionName: us-east-1
    awsAccountId: 389226183042
    routeTableCiderBlock: 10.0.0.0/21
    vpcId: vpc-abc

Exemplo de CRD independente

The following example shows an AtlasNetworkPeering independent CRD that configures the same VPC peering connection defined by the Basic Example. To enable resource management independent of the parent project, 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: AtlasNetworkPeering
metadata:
  name: green-leaf-peering
spec:
  externalProjectRef:
    projectId: 66e2f2b621571b7e69a89b66
  connectionSecret:
    name: atlas-connection-secret
  containerRef:
    id: 72a6d2a69388ba121943ae27
  id: 72a6d2a69388ba121943ae27
  provider: AWS
  awsConfiguration:
    accepterRegionName: us-east-1
    awsAccountId: 389226183042
    routeTableCiderBlock: 10.0.0.0/21
    vpcId: vpc-abc

Parâmetros

AtlasNetworkPeering

AtlasNetworkPeering é o esquema para a API AtlasNetworkPeering

`Name`	Tipo	Descrição	Obrigatório
`apiVersion`	string	atlas.mongodb.com/v1	true
`kind`	string	`AtlasNetworkPeering`	true
`metadata`	objeto	Consulte a documentação do Kubernetes `API` para os campos do campo `metadata`.	true
`spec`	objeto	`AtlasNetworkPeeringSpec` define o estado alvo de `AtlasNetworkPeering`. 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 (has(auto.``containerRef``.name) && !has(auto.``containerRef``.id)) \|\| (!has(auto.''containerRef''.name) && has(auto.``containerRef``.id)): deve ter um id de contêiner Atlas ou nome Kubernetes, mas não ambos (ou nenhum) (auto.``containerRef``.name == `oldSelf`.``containerRef``.name) \|\| (!has(auto.''containerRef''.name) && !has(`oldSelf`.``containerRef``.name)): o nome de referência do contêiner é imutável (auto.``containerRef``.id == `oldSelf`.``containerRef``.id) \|\| (!has(auto.``containerRef``.id) && !has(`oldSelf`.``containerRef``.id)): a ID de referência do contêiner é imutável (auto.id == `oldSelf`.id) \|\| (!has(auto.id) && !has(`oldSelf`.id)): id é imutável	false
`status`	objeto	`AtlasNetworkPeeringStatus` é um `status` para o recurso Personalizado `AtlasNetworkPeering`. Não aquele incluído no `AtlasProject`	false

AtlasNetworkPeering.spec

AtlasNetworkPeeringSpec define o estado de destino do AtlasNetworkPeering.

`Name`	Tipo	Descrição	Obrigatório
`containerRef`	objeto	`ContainerDualReference` refere-se a um contêiner de rede pelo nome Kubernetes ou Atlas `ID`.	true
`provider`	enum	Nome do serviço de nuvem `provider` para o qual você deseja criar o serviço de emparelhamento de rede. enumeração: `AWS`, `GCP`, `AZURE`	true
`awsConfiguration`	objeto	AWSConfiguration são as configurações específicas do `AWS` para emparelhamento de rede.	false
`azureConfiguration`	objeto	`AzureConfiguration` são as configurações específicas do Azure para emparelhamento de rede.	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
`gcpConfiguration`	objeto	GCPConfiguration são as configurações específicas do Google Cloud para emparelhamento de rede.	false
`id`	string	`ID` é o identificador de emparelhamento para um emparelhamento de rede já existente a ser gerenciado pelo operador. Este campo é imutável.	false
`projectRef`	objeto	`projectRef` é uma referência ao recurso pai `AtlasProject`. Mutualmente exclusivo com o campo"`externalProjectRef`".	false

AtlasNetworkPeering.spec.containerRef

ContainerDualReference refere-se a um contêiner de rede pelo nome Kubernetes ou ID Atlas.

`Name`	Tipo	Descrição	Obrigatório
`id`	string	`ID` é o identificador Atlas do recurso Atlas do contêiner de rede do qual essa conexão de emparelhamento depende. Use o nome ou `ID`, não ambos.	false
`name`	string	O nome do recurso contêiner Kubernetes deve estar presente no mesmo namespace. Use `name` ou `ID`, não ambos.	false

AtlasNetworkPeering.spec.awsConfiguration

AWSConfiguration são as configurações específicas da AWS para emparelhamento de rede.

`Name`	Tipo	Descrição	Obrigatório
`accepterRegionName`	string	`AccepterRegionName` é o nome da região do provedor do vpc do usuário no formato de região nativo do `AWS`.	true
`awsAccountId`	string	`AccountID` do vpc do usuário.	true
`routeTableCidrBlock`	string	Usuário `VPC` `CIDR`.	true
`vpcId`	string	`AWS` `VPC` `ID`.	true

AtlasNetworkPeering.spec.azureConfiguration

AzureConfiguration são as configurações específicas do Azure para emparelhamento de rede.

`Name`	Tipo	Descrição	Obrigatório
`azureDirectoryId`	string	`AzureDirectoryID` é o identificador exclusivo de um diretório Azure `AD`.	true
`azureSubscriptionId`	string	`AzureSubscriptionID` é o identificador exclusivo da assinatura do Azure na qual a VNet reside.	true
`resourceGroupName`	string	`ResourceGroupName` é o nome do seu grupo de recursos do Azure.	true
`vNetName`	string	VNetName é o nome da sua VNet do Azure. É aplicável apenas ao Azure.	true

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

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

AtlasNetworkPeering.spec.gcpConfiguration

GCPConfiguration são as configurações específicas do Google Cloud para emparelhamento de rede.

`Name`	Tipo	Descrição	Obrigatório
`gcpProjectId`	string	Usuário `GCP` Projeto `ID`. É aplicável apenas para `GCP`.	true
`networkName`	string	`GCP` Nome do emparelhamento de rede. É aplicável apenas para `GCP`.	true

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

AtlasNetworkPeering.status

AtlasNetworkPeeringStatus é um status para o recurso personalizado AtlasNetworkPeering. 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
`awsStatus`	objeto	AWSStatus contém apenas informações de status relacionadas a `AWS`	false
`azureStatus`	objeto	`AzureStatus` contém apenas informações de status relacionadas ao Azure	false
`gcpStatus`	objeto	O GCPStatus contém apenas informações de status relacionadas a `GCP`	false
`id`	string	`ID` registra o identificador do emparelhamento criado pelo 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
`status`	string	O status descreve o último `status` visto para configurar o emparelhamento de rede	false

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

AtlasNetworkPeering.status.awsStatus

AWSStatus contém apenas informações de status relacionadas à AWS

`Name`	Tipo	Descrição	Obrigatório
`connectionId`	string	`ConnectionID` a conexão de emparelhamento `AWS` `VPC` é `ID`	false
`vpcId`	string	`VpcID` `AWS` `VPC` é o id do lado do Atlas	false

AtlasNetworkPeering.status.azureStatus

O AzureStatus contém informações de status relacionadas apenas ao Azure

`Name`	Tipo	Descrição	Obrigatório
`azureSubscriptionIDpcId`	string	`AzureSubscriptionID` O id de assinatura do Azure está do lado do Atlas	false
`vNetName`	string	`VnetName` é a rede Azure no lado do Atlas	false

AtlasNetworkPeering.status.gcpStatus

GCPStatus contém informações de status relacionadas apenas ao GCP

`Name`	Tipo	Descrição	Obrigatório
`gcpProjectID`	string	GCPProjectID é `GCP` projeto no lado do Atlas	false
`networkName`	string	`NetworkName` `GCP` é uma rede no lado do Atlas	false

Voltar

AtlasNetworkContainer

AtlasOrgSettings

AtlasNetworkPeering Recurso personalizado