/ /

Recursos personalizados

Docs Home

Gestión

Operador de Atlas Kubernetes

Recursos personalizados

Docs Home

Gestión

Operador de Atlas Kubernetes

Recursos personalizados

`AtlasNetworkContainer` Recurso personalizado

Importante

Los subrecursos tradicionales están en desuso desde la versión de sus CRD correspondientes. Si su configuración depende actualmente del formulario de subrecurso de esta definición de recurso, migrar a un CRD.

El recurso personalizado AtlasNetworkContainer define un contenedor de red para un proyecto de Atlas. Tú creas Conexiones de emparejamiento VPC entre contenedores de red y las redes donde se alojan tus aplicaciones.

Importante

Recursos personalizados ya no borran objetos por defecto

Atlas Kubernetes Operator uses custom resource archivos de configuración to manage your Atlas configuration, but as of Atlas Kubernetes Operator 2.0, custom resources you borrar in Kubernetes are no longer (por defecto) borrados in Atlas. En su lugar, Atlas Kubernetes Operator simplemente deja de gestionar esos recursos en Atlas. Por ejemplo, si eliminas un AtlasProject Custom recurso en Kubernetes, de forma predeterminada, el Atlas Kubernetes Operator ya no elimina automáticamente el Proyecto correspondiente de Atlas. Este cambio de comportamiento está diseñado para ayudar a prevenir eliminaciones accidentales o inesperadas. Para saber más, incluido cómo revertir este comportamiento al por defecto utilizado antes de Atlas Kubernetes Operator 2.0, consulta Nuevo valor por defecto: Protección de Eliminación en Atlas Kubernetes Operator 2.0.
Del mismo modo, Atlas Kubernetes Operator no elimina los equipos de Atlas si los eliminas de un proyecto Atlas en Kubernetes utilizando Atlas Kubernetes Operator.

Define explícitamente los detalles de configuración que deseas para evitar el uso implícito de los valores de configuración por defecto de Atlas. En algunos casos, heredar los valores por defecto de Atlas puede crear un ciclo de conciliación que impida que el recurso personalizado alcance un estado de READY. Por ejemplo, definir explícitamente el comportamiento de escalado automático deseado en el recurso personalizado AtlasDeployment, como se muestra en el ejemplo incluido, garantiza que un tamaño de instancia estático en el recurso personalizado no se aplique repetidamente a una implementación de Atlas que tiene el escalado automático habilitado.

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

Atlas Kubernetes Operator realiza una de las siguientes acciones mediante el Atlas Recurso API de emparejamiento de red:

Crea un nuevo contenedor de red.
Actualiza un contenedor de red existente.

Ejemplos

Los siguientes ejemplos ilustran las configuraciones para los AtlasNetworkContainer CRDs.

La configuración básica de ejemplo define un recurso que gestionas con la misma instancia del Atlas Kubernetes Operator con la que gestionas su proyecto padre de Atlas.
La configuración del CRD independiente configura el mismo contenedor de red que el ejemplo básico, pero para un Proyecto de Atlas que gestionas fuera de la instancia del Atlas Kubernetes Operator con la que gestionas el contenedor de red.

Ejemplo básico

Lo siguiente muestra un recurso personalizado AtlasNetworkContainer para un contenedor denominado my-atlas-nc que te permite crear una conexión de emparejamiento de VPC entre Atlas y AWS dentro del proyecto my-project. Para gestionar este recurso en la misma instancia del operador de Atlas Kubernetes que su proyecto principal, debe identificar el proyecto con projectRef en 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

Ejemplo independiente de CRD

En el siguiente ejemplo se muestra un AtlasNetworkContainer CRD independiente que permite el VPC emparejamiento bajo los mismos parámetros habilitados por el Ejemplo básico. Para habilitar la operación independiente, debe usar un externalProjectRef en lugar de un projectRef, y debe proporcionar un connectionSecret directamente ya que este recurso no puede heredar las credenciales de API de su proyecto principal.

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 es el esquema para la API de AtlasNetworkContainer

`Name`	Tipo	Descripción	Requerido
`apiVersion`	string	atlas.mongodb.com/v1	true
`kind`	string	`AtlasNetworkContainer`	true
`metadata`	Objeto	Consulta la documentación de Kubernetes `API` para obtener información sobre los campos del campo `metadata`.	true
`spec`	Objeto	`AtlasNetworkContainerSpec` define el estado objetivo de un `AtlasNetworkContainer`. validación: (tiene(self.``externalProjectRef``) && !has(self.``projectRef``)) \|\| (!has(self.``externalProjectRef``) && tiene(self.""projectRef"")): debe definir sólo una referencia de proyecto a través de `externalProjectRef` o `projectRef` (tiene(self.``externalProjectRef``) && tiene(self.``connectionSecret``)) \|\| !tiene(self.``externalProjectRef``): debe definir un secreto de conexión local cuando se referencia un proyecto externo (self.proveedor == '`GCP`' && !has(self.región)) \|\| (self.provider != '`GCP`'): no se debe establecer la región para los contenedores `GCP` ((self.proveedor == '`AWS`' \|\| self.proveedor == '`AZURE`') && has(self.región)) \|\| (self.provider == '`GCP`'): se debe configurar la región para contenedores `AWS` y Azure (self.id == `oldSelf`.id) \|\| (!has(self.id) && !has(`oldSelf`.id)): la id es inalterable (self.region == `oldSelf`.region) \|\| (!tiene(self.region) && !has(`oldSelf`.region)): la región es inmutable	false
`status`	Objeto	`AtlasNetworkContainerStatus` es un(a) `status` para el `AtlasNetworkContainer` recurso personalizado. No el incluido en el `AtlasProject`	false

AtlasNetworkContainer.spec

AtlasNetworkContainerSpec define el estado objetivo de un AtlasNetworkContainer.

`Name`	Tipo	Descripción	Requerido
`provider`	enum	El proveedor es el nombre de la nube `provider` que aloja el contenedor de red. Enum: `AWS`, `GCP`, `AZURE`	true
`cidrBlock`	string	Atlas `CIDR`. Debe configurarse si `ContainerID` no está establecido.	false
`connectionSecret`	Objeto	Nombre del secreto que contiene las claves privadas y las llaves públicas de Atlas `API`.	false
`externalProjectRef`	Objeto	`externalProjectRef` mantiene el proyecto principal de Atlas `ID`. Mutuamente excluyentes con el campo "`projectRef`".	false
`id`	string	`ID` es el identificador de contenedor para un contenedor de red ya existente que será gestionado por el operador. Este campo puede utilizarse en conjunto con `cidrBlock` para actualizar el `cidrBlock` de un contenedor existente. Este campo es inmutable.	false
`projectRef`	Objeto	`projectRef` es una referencia al recurso principal `AtlasProject`. Mutuamente excluyentes con el campo "`externalProjectRef`".	false
`region`	string	`ContainerRegion` es el proveedor `region` nombre del contenedor de red de Atlas en formato `region` de Atlas Esto es requerido por `AWS` y Azure, pero no es usado por `GCP`. Este campo es inmutable, Atlas no admite cambios en el contenedor de red.	false

AtlasNetworkContainer.spec.connectionSecret

Nombre del secreto que contiene las claves privadas y públicas de la API de Atlas.

`Name`	Tipo	Descripción	Requerido
`name`	string	Nombre del recurso al que se hace referencia Más información: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasNetworkContainer.spec.externalProjectRef

externalProjectRef contiene el ID del proyecto principal de Atlas. Mutuamente exclusivo con el campo 'projectRef'.

`Name`	Tipo	Descripción	Requerido
`id`	string	`ID` es el proyecto Atlas `ID`.	true

AtlasNetworkContainer.especificación.referenciaProyecto

projectRef es una referencia al recurso padre AtlasProject. Mutuamente excluyente con el campo "externalProjectRef".

`Name`	Tipo	Descripción	Requerido
`name`	string	Nombre del recurso de Kubernetes	true
`namespace`	string	namespace del recurso de Kubernetes	false

AtlasNetworkContainer.estado

AtlasNetworkContainerStatus es un estado para el recurso personalizado AtlasNetworkContainer. No el que se incluye en el AtlasProject

`Name`	Tipo	Descripción	Requerido
`conditions`	[]objeto	Condiciones es la lista de estados que muestra el estado actual del Recurso Personalizado Atlas	true
`id`	string	`ID` registra el identificador del contenedor en Atlas	false
`observedGeneration`	entero	`ObservedGeneration` indica la generación de la especificación del recurso de la que el operador Atlas tiene conocimiento. El operador de Atlas actualiza este campo al valor de 'metadatos.generation' tan pronto como comience la conciliación del recurso. Formato: int64	false
`provisioned`	booleano	Provisionadas es verdadero cuando los clústeres se han implementado en el contenedor antes de la última conciliación	false

AtlasNetworkContainer.status.conditions

La condición describe el estado de un recurso personalizado de Atlas en un momento determinado.

`Name`	Tipo	Descripción	Requerido
`status`	string	Estado de la condición; uno de Verdadero, Falso, Desconocido.	true
`type`	string	Tipo de condición de recursos personalizados de Atlas.	true
`lastTransitionTime`	string	La última vez, la condición pasó de un estado a otro. Representado en formato `ISO` 8601. Formato: fecha-hora	false
`message`	string	Un `message` que proporciona detalles sobre la transición.	false
`reason`	string	El `reason` para la última transición de la condición.	false

Volver

Lista de acceso IP de Atlas

AtlasNetworkPeering