/ /

`AtlasIPAccessList` Recurso personalizado

Importante

Los subrecursos heredados se deprecian desde la publicación de sus CRD correspondientes. Si tu configuración actualmente depende de la forma de subrecurso de esta definición de recurso, migra a un CRD.

El recurso personalizado AtlasIPAccessList configura una lista de acceso IP para un proyecto Atlas. Una lista de acceso IP permite proteger el Proyecto con una política de acceso mínimo.

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

El Atlas Kubernetes Operator realiza una de las siguientes acciones utilizando el recurso de API de lista de acceso de IP del Proyecto de Atlas :

Crea una nueva lista de acceso IP.
Reemplazar una lista de acceso IP existente.

Ejemplos

Ejemplo básico

El siguiente ejemplo muestra un recurso personalizado AtlasIPAccessList que permite el acceso al proyecto my-project desde las siguientes fuentes:

bloque CIDR 192.168.1.0/24
Dirección IP 10.0.0.1
Grupo de seguridad de AWS

El acceso desde 10.0.0.1 expira después del 31de marzo de 2025.

apiVersion: atlas.mongodb.com/v1
kind: AtlasIPAccessList
metadata:
  name: atlasipaccesslist-sample
spec:
  projectRef:
    name: my-project
    namespace: my-operator-namespace
  entries:
    - cidrBlock: 192.168.1.0/24
    - ipAddress: 10.0.0.1
      deleteAfterDate: 2025-03-31T23:59:59+02:00
    - awsSecurityGroup: sg-1234
      comment: "AWS Access to my network peering"

Ejemplo independiente de CRD

El siguiente ejemplo muestra un AtlasIPAccessList CRD independiente que permite el acceso desde el mismo bloque CIDR y la misma dirección IP permitido por el ejemplo básico. Esta definición de recurso personalizado le permite crear una lista de acceso IP en un Proyecto que gestione fuera de la instancia de Atlas Kubernetes Operator con la que define este recurso. 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: AtlasIPAccessList
metadata:
  name: atlasipaccesslist-sample
spec:
  externalProjectRef:
    projectId: 66e2f2b621571b7e69a89b66
  connectionSecret:
    name: atlas-connection-secret
  entries:
    - cidrBlock: 192.168.1.0/24
    - ipAddress: 10.0.0.1
      deleteAfterDate: 2025-03-31T23:59:59+02:00
    - awsSecurityGroup: sg-1234
      comment: "AWS Access to my network peering"

Parámetros

Esta sección describe los parámetros de recursos personalizados AtlasIPAccessList disponibles.

metadata.name

Tipo: string

Requerido

Nombre que el AtlasIPAccessList Recurso personalizado utiliza para agregar esta lista de acceso IP a un Proyecto.

metadata.namespace

Tipo: string

Opcional

Namespace en el que se desea contener el recurso personalizado atlasIPAccessList. Si no se especifica, Atlas Kubernetes Operator utiliza el espacio de nombres actual establecido por kubectl.

spec.connectionSecret.name

Tipo: string

Condicional

Nombre del secreto opaco que contiene el Identificador de la Organización y las claves API que el Atlas Kubernetes Operator utiliza para conectarse a Atlas. Si no se especifica, Atlas Kubernetes Operator elige por defecto una de las siguientes opciones:

El parámetro spec.connectionSecretRef.name de la matriz principal atlasProject
El secreto global por defecto, si spec.connectionSecretRef.name no está definido para el atlasProjectprincipal

Este parámetro es obligatorio para CRDs independientes.

El Atlas Kubernetes Operator supervisa los secretos solo con la etiqueta atlas.mongodb.com/type=credentials para evitar la supervisión de secretos innecesarios.

El siguiente ejemplo etiqueta un secreto:

kubectl label secret the-user-password atlas.mongodb.com/type=credentials

spec.entries

Tipo: arreglo

Requerido

Conjunto de fuentes de conexión desde las cuales permitir el acceso al proyecto.

spec.entries.[n].awsSecurityGroup

Tipo: string

Condicional

Identificador único del grupo de seguridad AWS desde el cual conceder acceso al proyecto.

Cada entrada en spec.entries debe tener uno y solo uno de awsSecurityGroup, cidrBlock o ipAddress.

spec.entries.[n].cidrBlock

Tipo: string

Condicional

Rango de direcciones IP en notación de bloque CIDR desde el cual conceder acceso al proyecto.

Cada entrada en spec.entries debe tener uno y solo uno de awsSecurityGroup, cidrBlock o ipAddress.

spec.entries.[n].comment

Tipo: string

Opcional

Comentario asociado con esta entrada en la lista de acceso.

spec.entries.[n].deleteAfterDate

Tipo: string

Opcional

Fecha y hora después de las cuales Atlas borra la entrada de la lista de acceso temporal.

Para crear una entrada permanente en la lista de acceso, omite este parámetro.

spec.entries.[n].ipAddress

Tipo: string

Opcional

Dirección IP única desde la cual conceder acceso al proyecto.

Cada entrada en spec.entries debe tener uno y solo uno de awsSecurityGroup, cidrBlock o ipAddress.

spec.externalProjectRef.id

Tipo: string

Condicional

ID del proyecto a la que pertenece la lista de acceso IP. Debe especificar el ID del grupo de un Proyecto Atlas existente. Este parámetro es necesario para las listas de acceso IP que pertenecen a proyectos gestionados por cualquiera de los siguientes:

Una instancia diferente de Atlas Kubernetes Operator
Herramientas distintas del Atlas Kubernetes Operator

Para los despliegues que pertenecen a proyectos gestionados por la misma instancia de Atlas Kubernetes Operator, utilizar spec.projectRef.name si no se utiliza spec.externalProjectRef.id.

Una lista de acceso IP solo puede pertenecer a un proyecto. Para definir la misma lista de acceso IP para varios proyectos, crea definiciones de recursos personalizados para cada proyecto.

spec.projectRef.name

Tipo: string

Condicional

Nombre del proyecto al que pertenece la lista de acceso IP. Debe especificar un AtlasProject Recurso personalizado existente. Este parámetro se aplica únicamente a listas de accesos IP que pertenezcan a proyectos gestionados por la misma instancia de Atlas Kubernetes Operator.

Para implementaciones que pertenecen a proyectos gestionados por cualquiera de las siguientes opciones:

una instancia diferente de Atlas Kubernetes Operator
Herramientas distintas del Atlas Kubernetes Operator

usar spec.externalProjectRef.id.

Una lista de acceso IP solo puede pertenecer a un proyecto. Para definir la misma lista de acceso IP para varios proyectos, crea definiciones de recursos personalizadas para cada proyecto.

spec.projectRef.namespace

Tipo: string

Condicional

Espacio de nombres en el que existe el AtlasProject Recurso personalizado especificado en spec.projectRef.name.

No establezcas este parámetro para los despliegues que pertenezcan a proyectos gestionados por:

una instancia diferente de Atlas Kubernetes Operator
Herramientas distintas del Atlas Kubernetes Operator

Empezar

AtlasIPAccessList Recurso personalizado

Ejemplos

Ejemplo básico

Ejemplo independiente de CRD

Parámetros

`AtlasIPAccessList` Recurso personalizado