AtlasDeployment Recurso personalizado

Migración a clústeres Flex

Cambios disruptivos con Atlas Kubernetes Operator 2.0

Acerca del Recurso Personalizado AtlasDeployment

El recurso personalizado AtlasDeployment configura tu clúster de MongoDB o clúster de Flex en Atlas. Cuando creas el recurso personalizado AtlasDeployment, Atlas Kubernetes Operator intenta crear o actualizar un clúster o un clúster Flex en Atlas.

El operador de Kubernetes de Atlas realiza una de las siguientes acciones según los valores que especifiques en el recurso personalizado AtlasDeployment:

• Si especifica valores para los campos en spec.deploymentSpec, Atlas Kubernetes Operator utiliza el Atlas recurso de la API de clústeres para crear un clúster nuevo o actualizar uno existente.

• Si especificas valores para los campos bajo spec.flexSpec, Atlas Kubernetes Operator usa el Atlas Flex Instancia API Recurso para crear un nuevo clúster Flex o actualizar un clúster Flex existente.

La creación de un clúster Atlas de nivel gratuito lleva menos de 15 segundos.

Crear o actualizar un clúster Flex o un clúster Dedicado puede tardar hasta 10 minutos. Atlas Kubernetes Operator supervisa el proceso de actualización.

Puedes ejecutar el siguiente comando para verificar el estado:

kubectl get atlasdeployment -o yaml

El siguiente ejemplo muestra la sección de estado de un clúster en proceso de provisionamineto:

status:
  conditions:
  - lastTransitionTime: "2024-03-18T16:32:43Z"
    status: "False"
    type: ClusterReady
    reason: ClusterCreating
    message: Cluster is provisioning

El estado ClusterReady cambiará a True cuando el clúster o la instancia sin servidor estén listos.

Ejemplos

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  namespace: mongodb-atlas-system
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    name: test-cluster
    tags:
    - key: "environment"
      value: "production"
    replicationSpecs:
      - zoneName: US-Zone
        numShards: 3
        regionConfigs:
          - regionName: CENTRAL_US
            providerName: GCP
            backingProviderName: GCP
            priority: 7
            electableSpecs:
              instanceSize: M10
              nodeCount: 3
status:
  conditions:
  - lastTransitionTime: "2024-03-18T16:32:43Z"
    status: "True"
    type: Ready
  - lastTransitionTime: "2024-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: 6.0
  mongoURIUpdated: "2024-03-12T12:21:41Z"
  observedGeneration: 1
  stateName: IDLE

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: test-cluster-name
  namespace: mongodb-atlas-system
spec:
  projectRef:
    name: development
  deploymentSpec:
    clusterType: REPLICASET
    name: service-name
    tags:
    - key: "environment"
      value: "production"
    backupEnabled: true
    replicationSpecs:
      - numShards: 1
        regionConfigs:
         - regionName: EASTERN_US
           providerName: GCP
           autoScaling:
             diskGB:
               enabled: true
             compute:
               enabled: true
               scaleDownEnabled: true
               minInstanceSize: M30
               maxInstanceSize: M40
           analyticsSpecs:
             instanceSize: M30
             nodeCount: 1
           electableSpecs:
             instanceSize: M30
             nodeCount: 3
           priority: 7
           readOnlySpecs:
             instanceSize: M30
             nodeCount: 1

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    name: test-cluster
    tags:
    - key: "environment"
      value: "production"
    replicationSpecs:
      - zoneName: Zone 1
        regionConfigs:
         - electableSpecs:
             instanceSize: M10
             nodeCount: 3
           providerName: AWS
           regionName: US_EAST_1
           priority: 7
  processArgs:
    javascriptEnabled: false

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: test-cluster-name
  namespace: mongodb-atlas-system
spec:
  projectRef:
    name: my-project
  flexSpec:
    name: flex-cluster
    tags:
      - key: "environment"
        value: "production"
    providerSettings:
      backingProviderName: AWS
      regionName: US_EAST_1

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: test-cluster-name
  namespace: mongodb-atlas-system
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
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: tenantCluster
    tags:
    - key: "environment"
      value: "production"
    replicationSpecs:
      - zoneName: Zone 1
        regionConfigs:
        priority: 7
        - electableSpecs:
            instanceSize: M10
            nodeCount: 3
          providerName: AWS
          regionName: US_EAST_1

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    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

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  namespace: mongodb-atlas-system
spec:
  deploymentSpec:
    backupEnabled: true
    clusterType: REPLICASET
    name: Test-cluster-M10
    replicationSpecs:
    - regionConfigs:
      - backingProviderName: AWS
        electableSpecs:
          instanceSize: M10
          nodeCount: 3
        priority: 7
        providerName: AWS
        regionName: US_EAST_1
      zoneName: Zone 1
    searchIndexes:
    - DBName: sample_training
      collectionName: grades
      name: test-vector-search-index
      type: vectorSearch
      vectorSearch:
        fields:
        - numDimensions: 1000
          path: student_id
          similarity: euclidean
          type: vector
    - DBName: sample_airbnb
      collectionName: listingsAndReviews
      name: my-index
      search:
        mappings:
          dynamic: true
        searchConfigurationRef:
          name: atlassearchindexconfig-sample
          namespace: mongodb-atlas-system
      type: search
    terminationProtectionEnabled: false
  projectRef:
    name: my-project
    namespace: mongodb-atlas-system

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  namespace: mongodb-atlas-system
spec:
  deploymentSpec:
    backupEnabled: true
    clusterType: REPLICASET
    name: Test-cluster-M10
    replicationSpecs:
    - regionConfigs:
      - backingProviderName: AWS
        electableSpecs:
          instanceSize: M10
          nodeCount: 3
        priority: 7
        providerName: AWS
        regionName: US_EAST_1
      zoneName: Zone 1
    searchNodes:
    - instanceSize: S20_HIGHCPU_NVME
      nodeCount: 2

Parámetros

Esta sección describe algunos de los parámetros clave de recursos personalizados de AtlasDeployment disponibles.

• Para consultar la lista completa de parámetros disponibles para los clústeres, consulta la API de clústeres de Atlas.

• Para obtener una lista completa de los parámetros disponibles para los clústeres Flex, consulte la API de clústeres Flex de Atlas.

Consulta Notas de la Transición hacia Clústeres Flex para obtener información completa sobre los cambios.

Para personalizar tus especificaciones, consulta estas descripciones, los ejemplos disponibles y la documentación de la API.

spec.backupRef

Tipo: objeto

Opcional

Lista que contiene los detalles de AtlasBackupSchedule recurso personalizado que deseas aplicar. Puedes especificar un cronograma de copia de seguridad por clúster.

spec.backupRef.name

Tipo: string

Opcional

metadata.name Valor dentro del recurso AtlasBackupSchedule personalizado para la programación de copias de seguridad que desea aplicar. Puede especificar solo una programación de copias de seguridad por clúster, pero puede usar la misma programación para varios clústeres.

Si omites este parámetro, Atlas no aplicará la configuración de tu copia de seguridad a este clúster.

spec.backupRef.namespace

Tipo: string

Opcional

Cadena que indica el espacio de nombres que contiene el recurso AtlasBackupSchedule personalizado para la programación de copia de seguridad que desea aplicar.

spec.configServerManagementMode

Tipo: string

Opcional

Por defecto: ATLAS_MANAGED

Configuración que define el modo de gestión del servidor para crear o actualizar un clúster. Los valores posibles son:

• ATLAS_MANAGED: Atlas puede cambiar automáticamente el tipo de servidor de configuración del clúster para optimizar el rendimiento y los ahorros.

• FIXED_TO_DEDICATED:El clúster siempre utiliza un servidor de configuración dedicado.

Obtén más información sobre Servidores de configuración en clústeres particionados de MongoDB.

spec.connectionSecret.name

Tipo: string

Condicional

Nombre del secretoopacoQue contiene el ID de la organización y las claves API que Atlas Kubernetes Operator utiliza para conectarse a Atlas. Si no se especifica, Atlas Kubernetes Operator recurre a:

• El parámetro spec.connectionSecretRef.name de la matriz principal atlasProject

• El secreto predeterminado global, si spec.connectionSecretRef.name no está definido para el padre atlasProject

Este parámetro es obligatorio para los CRD independientes.

spec.deploymentSpec

Tipo: arreglo

Condicional

Lista que contiene los parámetros del clúster de la API. Para obtener una lista completa de los parámetros disponibles, consulte la API de clústeres de Atlas.

Importante

Debes especificar spec.deploymentSpec o spec.flexSpec en tu configuración.

Consulta Notas de la Transición hacia Clústeres Flex para obtener información completa sobre los cambios.

spec.deploymentSpec.name

Tipo: string

Condicional

string que identifica el nombre del clúster. El nombre debe contener solo letras, números y guiones, y no puede ser modificado después de la creación de la implementación.

spec.deploymentSpec.clusterType

Tipo: string

Condicional

Etiqueta legible por humanos que identifica el tipo de clúster a crear.

¿Cuándo se debe utilizar este parámetro?

Condición	Necesidad
Configura spec.deploymentSpec.replicationSpecs.	Requerido
Estás implementando Clústeres globales.	Requerido
Estás implementando sets de réplicas y clústeres fragmentados no globales.	Opcional

Atlas acepta:

Valor	Tipo de clúster
Set de réplicas	set de réplicas
FRAGUADO	clúster fragmentado
GEOSHARDED	clúster global

spec.deploymentSpec.customZoneMapping

Tipo: arreglo

Requerido

Lista que contiene Parámetros del clúster global que asignan zonas a regiones geográficas. Para una lista completa de los parámetros disponibles, consulta el API de Clústeres Globales.de Atlas

spec.deploymentSpec.customZoneMapping.location

Tipo: string

Requerido

Código que representa una ubicación que corresponde a una zona en su clúster global.

spec.deploymentSpec.customZoneMapping.zone

Tipo: string

Requerido

Etiqueta legible por humanos que identifica la zona en su clúster global.

spec.deploymentSpec.diskSizeGB

Tipo: número

Opcional

Capacidad, en gigabytes, que indica el volumen raíz del host. Aumente este número para agregar capacidad, hasta un valor máximo posible de 4096 (4 TB). Debe especificar un número positivo para este valor.

No puedes establecer este valor para los clústeres con SSD NVMe locales.

Nota

Si habilitas el escalado automático para diskGB en cualquier región, no puedes editar esta opción. Para obtener más información, consulta spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabled.

El tamaño mínimo de disco para clústeres dedicados es de 10 GB para AWS y Google Cloud. Si especifica esta configuración con un tamaño de disco menor, Atlas establece por defecto el valor mínimo del tamaño de disco.

Si la implementación de la base de datos incluye nodos Azure, este valor debe corresponder a un tipo de disco Azure existente (8, 16, 32, 64, 128, 256, 512, 1024, 2048 o 4096).

Atlas calcula los cargos por almacenamiento de manera diferente según si eliges el valor por defecto o un valor personalizado.

Atlas tiene límites de capacidad de disco en los conjuntos de réplicas únicos, que pueden escalar hasta 4 TB en los niveles de clúster superiores. Para expandir el almacenamiento total del clúster más allá de los límites por defecto, puedes habilitar el almacenamiento extendido en la Configuración del Proyecto. Para acomodar una mayor escalabilidad en el futuro, recomendamos que habilite el particionado para una expansión a largo plazo.

Si la implementación de la base de datos abarca proveedores de servicios en la nube, este valor se establece por defecto en el mínimo por defecto de los proveedores involucrados.

Para obtener más información, consulta Capacidad de almacenamiento.

spec.deploymentSpec.encryptionAtRestProvider

Tipo: string

Opcional

Proveedor de servicios en la nube que administra la clave de cliente para este clúster. Debe configurar este valor para habilitar el cifrado en reposo mediante claves administradas por el cliente para este clúster, lo que proporciona una capa adicional de cifrado. Para obtener más información, consulte Cifrar datos mediante un servicio de administración de claves.

Atlas acepta los siguientes valores:

Valor	Proveedor de nube
AWS	Amazon AWS
GCP	Google Cloud
Azure	Microsoft Azure
Ninguno	Sin proveedor; el clúster no encripta datos utilizando claves gestionadas por el cliente.

spec.deploymentSpec.managedNamespaces

Tipo: arreglo

Requerido

Lista que contiene información para crear un namespace gestionado en un Clúster global especificado. Para una lista completa de los parámetros disponibles, consulta el API de Clústeres Globales.de Atlas

spec.deploymentSpec.managedNamespaces.collection

Tipo: string

Requerido

Etiqueta legible por humanos de la colección a gestionar en este Clúster Global.

spec.deploymentSpec.managedNamespaces.db

Tipo: string

Requerido

Etiqueta legible por humanos de la base de datos que se administrará en este Clúster Global.

spec.deploymentSpec.managedNamespaces.isCustomShardKeyHashed

Tipo: booleano

Opcional

Indicador que indica si se debe aplicar un hash a la clave de partición personalizada para la colección especificada. Este parámetro tiene como valor por defecto false.

• Establezca en true para habilitar una clave de fragmento personalizada para la colección.

• Establece en false para desactivar una clave de partición personalizada para la colección. Si está deshabilitado, MongoDB utiliza particionado clasificado por rango.

Para obtener más información, consulta Claves de partición con hash.

spec.deploymentSpec.managedNamespaces.isCustomShardKeyUnique

Tipo: booleano

Opcional

Indicador que señala si la clave de partición personalizada para la colección especificada es única. Este parámetro está configurado por defecto a false.

• Establece en true para habilitar una clave de partición personalizada única para la colección.

• Configura en false para desactivar una clave única de shard personalizada para la colección.

spec.deploymentSpec.managedNamespaces.numInitialChunks

Tipo: entero

Opcional

Número mínimo de fragmentos a crear inicialmente al fragmentar una colección vacía con una clave de fragmento con hash.

Para obtener más información, consulte partición una colección global.

spec.deploymentSpec.managedNamespaces.presplitHashedZones

Tipo: booleano

Opcional

Indicador que señala si MongoDB Cloud debe crear y distribuir fragmentos iniciales para una colección vacía o inexistente. Este parámetro tiene como valor por defecto false.

• Establezca en true para que MongoDB Cloud cree y distribuya fragmentos iniciales para una colección vacía o inexistente.

• Configúralo en false para evitar que MongoDB Cloud cree y distribuya fragmentos iniciales para una colección vacía o inexistente...

spec.deploymentSpec.mongoDBMajorVersion

Tipo: string

Opcional

Versión del clúster a implementar. Atlas soporta las siguientes versiones de MongoDB para los clústeres M10+:

• 5.0

• 6.0

• 7.0

• 8.0

Las siguientes condiciones producen los siguientes resultados:

Condición	Resultado
Omite este parámetro y omite el spec.deploymentSpec.versionReleaseSystem parámetro.	Atlas implementa un clúster que ejecuta MongoDB 7.0.
Omite este parámetro y establece el spec.deploymentSpec.versionReleaseSystem parámetro LTS en.	Atlas implementa un clúster que ejecuta MongoDB 7.0.
Atlas dejó obsoletos M2 M5 los clústeres y y las instancias sin servidor. Para obtener más información, consulte Migración a clústeres flexibles. Establezca el spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize parámetro M0 en, M2 M5o.	Debe implementar MongoDB 7.0 o una versión posterior.
Usted especifica este parámetro.	Atlas siempre implementa el clúster con la última versión parche estable de la versión especificada.
Ha configurado el parámetro spec.deploymentSpec.versionReleaseSystem en CONTINUOUS.	Debes omitir este parámetro.

spec.deploymentSpec.pitEnabled

Tipo: booleano

Condicional

Nota

Atlas ha desaprobado los clústeres M2 y M5 y las instancias sin servidor. Atlas migró todos los clústeres M2 y M5 a clústeres Flex. Para instancias sin servidor, Atlas migró instancias a clústeres gratuitos, clústeres Flex o clústeres dedicados según su uso.

Para preservar la compatibilidad con versiones anteriores de las API durante un tiempo, Atlas seguirá permitiendo que estos clústeres migrados se administren mediante las mismas API (antiguas y nuevas), incluso al usar Atlas Kubernetes Operator. La compatibilidad con versiones anteriores de las API se mantendrá hasta enero de 2026, fecha en la que se eliminarán las API antiguas y solo se mantendrán las API relacionadas con los clústeres Flex.

El soporte para nodos privados en instancias sin servidor finalizó en marzo 2025. Debes actualizar la configuración de tu Atlas Kubernetes Operator para eliminar los nodos privados antes de marzo 2025. Debe remover todas las funcionalidades restantes de M2, M5 y de instancias sin servidor de sus configuraciones de Atlas Kubernetes Operator antes del 2026 de enero.

Si tus cargas de trabajo requieren nodos privados o copia de seguridad continua, cambia a Atlas clústeres dedicados. Para obtener más información, consulta Migración a Clusters Flex y la Guía de migración de Atlas Flex.

Configuración que permite la copia de seguridad continua en la nube. Para activar la copia de seguridad continua en la nube, debes especificar true para esta configuración.

spec.deploymentSpec.replicationSpecs

Tipo: arreglo de objetos

Condicional

Lista que contiene las configuraciones para las regiones de tu clúster. Use este parámetro para clústeres multiregionales. Debe configurar spec.deploymentSpec.replicationSpecs.regionConfigs.regionName o spec.deploymentSpec.replicationSpecs.

¿Cuándo se debe utilizar este parámetro?

Condición	Necesidad	Values
Estás implementando Clústeres globales.	Requerido	Cada objeto en el arreglo representa una zona donde Atlas implementa los nodos de tu clúster.
Estás implementando sets de réplicas y clústeres fragmentados no globales.	Opcional	Este arreglo contiene un objeto que representa donde Atlas implementa los nodos de tu clúster.

Si especificas este parámetro, también debes especificar spec.deploymentSpec.clusterType y spec.deploymentSpec.replicationSpecs.numShards.

spec.deploymentSpec.replicationSpecs.numShards

Tipo: entero

Condicional

Entero positivo que especifica el número de particiones a implementar en un clúster de fragmentos.

Si utiliza el parámetro spec.deploymentSpec.replicationSpecs, debe configurar este parámetro.

Atlas acepta 1 hasta 50, inclusive. El valor por defecto es 1.

• Si especifica un valor de 1 y establece spec.deploymentSpec.clusterType en SHARDED, Atlas implementa un clúster particionado de un solo fragmento.

• Si especificas 1 y estableces spec.deploymentSpec.clusterType a REPLICASET, Atlas implementa un set de réplicas.

  No se debe crear un clúster particionado con una única partición para entornos de producción. Los clústeres particionados de una sola partición no ofrecen los mismos beneficios que las configuraciones multipartición.

  Tip

  • particionado

  • Número de nodos

Advertencia

Cuando uses un clúster fragmentado, MongoDB requiere que tus aplicaciones se conecten a una instancia de mongos para garantizar que tus aplicaciones interactúen adecuadamente con las particiones y otros componentes del clúster fragmentado. Si migras de un set de réplicas a un clúster, tus aplicaciones deben reiniciarse para habilitar la conexión al mongos del clúster. Como resultado, la API de administración de Atlas le impide migrar un set de réplicas directamente a un clúster con más de una partición. Después de migrar con éxito tu set de réplicas a un clúster de partición único y restablecer las conexiones de tu aplicación, puedes añadir particiones adicionales al clúster.

spec.deploymentSpec.replicationSpecs.regionConfigs

Tipo: arreglo

Requerido

Especificaciones de hardware para los nodos definidos para una región determinada. Cada objeto regionConfigs describe la prioridad de la región en las elecciones, así como la cantidad y el tipo de nodos MongoDB que Atlas implementa en ella.

Cada objeto regionConfigs debe tener un objeto analyticsSpecs, un objeto electableSpecs, o un objeto readOnlySpecs.

• M0Los clústeres M2, M5 o solo requieren electableSpecs.

• Los clústeres dedicados pueden especificar cualquiera de estas especificaciones, pero deben tener al menos un objeto electableSpecs dentro de un replicationSpec.

• Cada especificación de hardware debe utilizar el mismo instanceSize.

spec.deploymentSpec.replicationSpecs.regionConfigs.analyticsSpecs

Tipo: objeto

Opcional

Especificaciones de hardware para los nodos de análisis necesarios en la región. Los nodos de análisis gestionan datos analíticos, como las queries de reportes del BI Connector para Atlas. Los nodos de análisis son solo de lectura y nunca pueden convertirse en el primario.

Si no especificas este parámetro, Atlas no implementa análisis en esta región.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabled

Tipo: booleano

Opcional

Indicador que indica si esta implementación de base de datos habilita el escalado automático de discos. Este parámetro tiene el valor predeterminado true.

• Establecer a true para activar el escalado automático de disco.

• Establece en false para desactivar el escalado automático del disco.

La cantidad máxima de RAM para el nivel de clúster seleccionado y el tamaño del oplog pueden limitar el escalado automático del almacenamiento. Para obtener más información, consulta Personaliza tu almacenamiento.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled

Tipo: booleano

Opcional

Indicador que indica si el escalado automático del tamaño de la instancia está habilitado. Este parámetro tiene el valor predeterminado false.

• Establece en true para habilitar la autoescala del tamaño de la instancia. Si está habilitado, debe especificar un valor para spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize.

• Configúralo en false para desactivar el escalado automático del tamaño de instancia.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize

Tipo: string

Condicional

String que indica el tamaño máximo de la instancia al que la implementación de la base de datos puede escalar automáticamente (como M40). Debe especificar este parámetro si configura spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled en true.

Nota

Si establece un tamaño de instancia máximo menor que el tamaño de instancia actual de la implementación de la base de datos con el escalado automático habilitado, Atlas escala automáticamente el tamaño de instancia actual al valor máximo que especifique.

Por ejemplo, si el tamaño de instancia actual de la implementación de la base de datos es M40 y se establece el tamaño máximo de instancia en M30, Atlas escala automáticamente el tamaño de instancia actual a M30.

Si Atlas cambia el tamaño de instancia actual y no cambias el spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize en Atlas Kubernetes Operator para que coincida con el nuevo tamaño de instancia, Atlas Kubernetes Operator muestra una advertencia en los registros, pero no impide el escalado automático.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize

Tipo: string

Condicional

String que indica el tamaño mínimo de instancia al que tu implementación de la base de datos puede escalar automáticamente (como M10). Debes especificar este parámetro si configuras spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled en true.

Nota

Si estableces un tamaño mínimo de instancia mayor que el tamaño actual de instancia de la implementación de la base de datos con el escalado automático habilitado, Atlas automáticamente escala el tamaño de la instancia actual al valor mínimo que especifiques.

Por ejemplo, si el tamaño actual de la instancia de la implementación de la base de datos es M10 y se establece el tamaño mínimo de la instancia en M30, Atlas escala automáticamente el tamaño actual de la instancia a M30.

Si Atlas cambia el tamaño de instancia actual y no cambias el spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize en Atlas Kubernetes Operator para que coincida con el nuevo tamaño de instancia, Atlas Kubernetes Operator muestra una advertencia en los registros, pero no impide el escalado automático.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs

Tipo: objeto

Opcional

Especificaciones de hardware para nodos elegibles en la región. Los nodos elegibles pueden convertirse en los principales y habilitar lecturas locales.

Si no especifica esta opción, Atlas no implementará ningún nodo elegible en la región.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize

Tipo: string

Condicional

Especificación de hardware para los tamaños de instancia en esta región. Cada tamaño de instancia tiene una capacidad de almacenamiento y memoria predeterminada. El tamaño de instancia que seleccione se aplica a todos los hosts que contienen datos en su tamaño de instancia. Para obtener más información, consulte los tamaños de almacenamiento personalizados de AWS, GCP y Azure.

Si se implementa un clúster fragmentado o clúster global, se debe elegir un tamaño de instancia de M30 o mayor.

Si cambias el nombre del tamaño de la instancia después de implementar tu clúster, Atlas cambiará el despliegue de la base de datos al tamaño de instancia que especifiques, a menos que esté fuera del rango que especificaste en spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize y spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize con escalado automático habilitado. Para obtener más información, consulta spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize y spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize.

Nota

Si tienes el escalado automático habilitado para el campo de cómputo, no puedes editar esta opción. Para obtener más información, consulta spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled.

Nota

Puedes cambiar esta configuración para actualizar un clúster M0 o Flex a un clúster M10+. Sin embargo, no puedes usar esta configuración para actualizar un M0 o un clúster Flex a otro clúster gratuito o Flex.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.nodeCount

Tipo: entero

Condicional

Número de nodos elegibles que Atlas puede implementar en la región. Los nodos elegibles pueden convertirse en los principales y habilitar lecturas locales.

El total combinado de electableSpecs.nodeCount entre todos los objetos replicationSpecs.regionConfigs debe sumar 3, 5 o 7.

No se pueden crear nodos elegibles si spec.deploymentSpec.replicationSpecs.regionConfigs.priority está 0.

spec.deploymentSpec.replicationSpecs.regionConfigs.priority

Tipo: entero

Requerido

Se da prioridad a esta región cuando se realizan elecciones primarias.

Si su regionConfigs solo tiene readOnlySpecs, analyticsSpecs o ambos, establezca este valor en 0.

Si tienes varios objetos regionConfigs (tu clúster es multi-región o multi-nube), deben tener prioridades en orden descendente. La máxima prioridad es 7.

Ejemplo

Establezca su región de mayor prioridad en 7, su segunda prioridad en 6, y su región de tercera prioridad en 5. Si no tienes nodos elegibles, establece este valor en 0.

Si tu región ha configurado electableSpecs.nodeCount en 1 o superior, debe tener una prioridad exactamente una menos que otra región en el replicationSpecs.regionConfigs arreglo, a menos que sea la principal. La región de mayor prioridad debe tener una prioridad de 7. La prioridad más baja posible es 1.

La 7 región de prioridad identifica la región preferida del clúster. Atlas coloca el nodo principal en la región preferida. Las prioridades 1 a 7 son excluyentes: no se puede asignar una prioridad determinada a más de una región por clúster.

Ejemplo

Si tienes tres regiones, sus prioridades serían 7, 6 y 5, respectivamente. Si agregara dos regiones más para admitir nodos elegibles, las prioridades de esas regiones serían 4 y 3, respectivamente.

spec.deploymentSpec.replicationSpecs.regionConfigs.providerName

Tipo: string

Condicional

Proveedor de servicios en la nube en el que Atlas aprovisiona los hosts.

AWS	Amazon AWS
GCP	Google Cloud Platform
Azure	Microsoft Azure

spec.deploymentSpec.replicationSpecs.regionConfigs.regionName

Tipo: string

Condicional

Ubicación física de tu clúster de MongoDB. La región que elijas puede afectar la latencia de red para los clientes que acceden a tus bases de datos.

Para obtener una lista completa de los valores de los nombres de región, consulta las páginas de referencia del proveedor de nube:

• AWS

• GCP

• Azure

Para clústeres multirregionales, consulte spec.deploymentSpec.replicationSpecs. Debes configurar ya sea spec.deploymentSpec.replicationSpecs.regionConfigs.regionName o spec.deploymentSpec.replicationSpecs.

spec.deploymentSpec.replicationSpecs.regionConfigs.readOnlySpecs

Tipo: objeto

Opcional

Especificaciones de hardware para nodos de solo lectura en la región. Los nodos solo lectura nunca pueden convertirse en el miembro primario, pero pueden habilitar lecturas locales.

Si no especificas este parámetro, Atlas no implementa ningún nodo de solo lectura en la región.

spec.deploymentSpec.replicationSpecs.zoneName

Tipo: string

Opcional

Etiqueta legible por humanos que identifica la zona en un Clúster global. Proporcione este valor solo si establece spec.deploymentSpec.clusterType en GEOSHARDED.

spec.deploymentSpec.searchIndexes

Tipo: arreglo

Opcional

Un arreglo de SearchIndex objetos con campos que describen el índice de búsqueda. Cada objeto SearchIndex contiene los siguientes campos:

Campo	Tipo	Descripción
name	string	Etiqueta legible por humanos que identifica este índice. Debe ser único para una implementación.
DBName	string	Etiqueta legible por humanos que identifica la base de datos existente que contiene la colección con uno o más índices de Atlas Search. IMPORTANTE: La base de datos que especifique debe existir previamente. Si no tienes una base de datos existente, crea una.
collectionName	string	Etiqueta legible por humanos que identifica la colección que contiene uno o más índices de búsqueda de Atlas.
type	string	Tipo de índice. Atlas acepta los siguientes valores: search vectorSearch
search	Objeto	Debes incluir este objeto si type es search. En caso contrario, omítelo.
vectorSearch	Objeto	Debes incluir este objeto si type es vectorSearch. En caso contrario, omítelo.

spec.deploymentSpec.searchIndexes.search

Tipo: objeto

Opcional

Campo	Tipo	Descripción
synonyms	arreglo	Conjuntos de reglas que asignan palabras a sus sinónimos en este índice
mappings	Objeto	Especificaciones de índice para los campos de la colección Requerido
searchConfigurationRef	Objeto	Una referencia de nombre/espacio de nombres al recurso personalizado AtlasSearchIndexConfig, descrito a continuación. Requerido

spec.deploymentSpec.searchIndexes.search.synonyms

Tipo: arreglo

Opcional

Un arreglo de objetos Synonym con campos que describen conjuntos de reglas que asocian palabras a sus sinónimos en este índice. Cada objeto Synonym contiene los siguientes campos:

Campo	Tipo	Descripción
name	string	Etiqueta legible por humanos que identifica la definición del sinónimo. Cada nombre debe ser único dentro de la misma definición de índice Requerido
analyzer	string	Método específico predefinido seleccionado para aplicar a los sinónimos que se buscarán. Los valores posibles son: lucene.standard lucene.standard lucene.simple lucene.whitespace lucene.keyword lucene.arabic lucene.armenio lucene.basque lucene.bengali lucene.brazilian lucene.bulgarian lucene.catalan lucene.chinese lucene.cjk lucene.czech lucene.danés lucene.dutch lucene.english lucene.finnish lucene.french lucene.galician lucene.german lucene.greek lucene.hindi lucene.húngaro lucene.indonesian lucene.irish lucene.italiano lucene.japonés lucene.korean lucene.kuromoji lucene.latvian lucene.lithuanian lucene.morfologik lucene.nori lucene.norwegian lucene.persian lucene.portuguese lucene.rumano lucene.russian lucene.smartcn lucene.sorani lucene.español lucene.swedish lucene.thai lucene.turco lucene.ucraniano Requerido
source	Objeto	Conjunto de datos que almacena la asignación de una o más palabras que se asignan a uno o más sinónimos de esas palabras Requerido

spec.deploymentSpec.searchIndexes.search.synonyms.source

Tipo: objeto

Requerido

Campo	Tipo	Descripción
collection	string	Etiqueta legible por humanos que identifica la colección de MongoDB que almacena palabras y sus sinónimos aplicables Requerido

spec.deploymentSpec.searchIndexes.search.mappings

Tipo: objeto

Requerido

Un objeto con especificaciones de índice para los campos de la colección:

dynamic	booleano	Indicador que permite determinar si el índice utiliza mapeos dinámicos o estáticos. Obligatorio si se omite mappings.fields.
fields	JSON/YAML	Una o más especificaciones de campos para el índice de búsqueda de Atlas. Obligatorio si mappings.dynamic no se incluye o se establece en falso.

spec.deploymentSpec.searchIndexes.vectorSearch

Tipo: objeto

Opcional

Campo	Tipo	Descripción
fields	JSON/YAML	Arreglo de objetos JSON. Consulta ejemplos en https://dochub.mongodb.org/core/avs-vector-type Requerido

spec.deploymentSpec.searchNodes

Tipo: arreglo

Opcional

Una matriz de configuraciones de nodos de búsqueda. Cada elemento contiene dos campos:

Campo	Tipo	Descripción
nodeCount	entero	Número de nodos de búsqueda en el clúster. Atlas acepta valores del 2 al 32, inclusive. El número por defecto es 2.
instanceSize	string	Especificación de hardware para los tamaños de instancia de nodo de búsqueda. Atlas acepta una de las siguientes: S20_HIGHCPU_NVME S30_HIGHCPU_NVME S40_HIGHCPU_NVME S50_HIGHCPU_NVME S60_HIGHCPU_NVME S70_HIGHCPU_NVME S80_HIGHCPU_NVME S30_LOWCPU_NVME S40_LOWCPU_NVME S50_LOWCPU_NVME S60_LOWCPU_NVME S80_LOWCPU_NVME S90_LOWCPU_NVME S100_LOWCPU_NVME El tamaño de instancia predeterminado es S20_HIGHCPU_NVME.

spec.deploymentSpec.tags

Tipo: arreglo

Opcional

Lista que contiene etiquetas (pares clave-valor) para entender mejor, organizar e identificar tus implementaciones de la base de datos. Para obtener más información, consulta Etiquetas en clusters.

spec.deploymentSpec.terminationProtectionEnabled

Tipo: booleano

Indica si la protección contra terminaciones está activa o inactiva para el clúster. Si está establecido en true, Atlas no borrará el clúster. Si se establece en false, Atlas borrará el clúster. El valor por defecto es false.

spec.deploymentSpec.versionReleaseSystem

Tipo: string

Condicional

Cadencia de lanzamiento que Atlas utiliza para este clúster. Atlas acepta:

• CONTINUOUSAtlas crea su clúster usando la versión más reciente de MongoDB. Atlas actualiza automáticamente tu clúster a las últimas versiones principales y rápidas de MongoDB a medida que estén disponibles.

• LTSAtlas crea tu clúster utilizando la última versión del parche de la versión de MongoDB que especifiques en el parámetro spec.deploymentSpec.mongoDBMajorVersion. Atlas actualiza automáticamente su clúster a los siguientes lanzamientos de parches de esta versión de MongoDB. Atlas no actualiza su clúster a versiones rápidas o importantes más recientes de MongoDB a medida que están disponibles.

  Si se omite, es por defecto LTS.

  Si establece este parámetro en CONTINUOUS, debe omitir el parámetro spec.deploymentSpec.mongoDBMajorVersion.

spec.externalProjectRef.id

Tipo: string

Condicional

ID del Proyecto al que pertenece la implementación. Debes especificar el ID del grupo de un Proyecto de Atlas existente. Este parámetro es obligatorio para implementaciones que pertenecen a proyectos administrados por:

• Una instancia diferente de Atlas Kubernetes Operator

• Herramientas distintas del Atlas Kubernetes Operator

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

spec.flexSpec

Tipo: arreglo

Condicional

Nota

Consulta Notas de la Transición hacia Clústeres Flex para obtener información completa sobre los cambios.

Lista que contiene los parámetros del clúster Flex de la API. Para obtener una lista completa de los parámetros disponibles, consulte la API de clústeres Flex de Atlas.

Importante

Debes especificar spec.deploymentSpec o spec.flexSpec en tu configuración.

spec.flexSpec.name

Tipo: string

string que identifica el nombre del clúster Flex.

spec.flexSpec.tags

Tipo: arreglo

Opcional

Lista que contiene etiquetas (pares clave-valor) para entender mejor, organizar e identificar tus implementaciones de la base de datos. Para obtener más información, consulta Etiquetas en clusters.

spec.flexSpec.terminationProtectionEnabled

Tipo: booleano

Indica si la protección de terminación está habilitada o deshabilitada para su clúster Flex. Si se establece en true, Atlas no eliminará el clúster. Si se establece en false, Atlas eliminará el clúster. El valor predeterminado es false.

spec.flexSpec.providerSettings.backingProviderName

Tipo: string

El nombre del proveedor de nube para su clúster Flex. providerSettings incluye la configuración que especifica las configuraciones para los hosts aprovisionados en los que se ejecuta MongoDB.

Atlas acepta uno de los siguientes valores:

• AWS

• AZURE

• GCP

spec.flexSpec.providerSettings.regionName

Tipo: string

Ubicación física de su clúster MongoDB Flex. La región que elija puede afectar la latencia de red para los clientes que acceden a sus bases de datos.

Para obtener una lista completa de los valores de los nombres de región, consulta las páginas de referencia del proveedor de nube:

• AWS

• GCP

• Azure

spec.processArgs

Tipo: objeto

Opcional

Objeto que contiene las opciones de configuración adicionales para su clúster.

spec.processArgs.defaultReadConcern

Tipo: string

Opcional

String que indica el nivel predeterminado de reconocimiento solicitado de MongoDB para las operaciones de lectura establecido para este clúster.

Los 5.0 clústeres MongoDB tienen como valor predeterminado ser locales.

spec.processArgs.defaultWriteConcern

Tipo: string

Opcional

String que indica el nivel por defecto de reconocimiento solicitado a MongoDB para las operaciones de escritura establecido para este clúster.

A partir de la versión 5.0 de MongoDB, los clústeres utilizan por defecto la mayoría.

spec.processArgs.failIndexKeyTooLong

Tipo: booleano

Opcional

Indicador que indica si debe fallar la operación y devolver un error cuando se insertan o actualizan documentos en los que todas las entradas de índice superan los 1024 bytes. Si se configura esto en false, mongod escribe documentos que superan este límite, pero no los indexa.

Esta opción corresponde al parámetro param.failIndexKeyTooLong mongod.

spec.processArgs.javascriptEnabled

Tipo: booleano

Opcional

Bandera que indica si el clúster permite la ejecución de operaciones que realizan ejecuciones de JavaScript del lado del servidor.

• Esta opción corresponde a modificar la opción de archivo de configuración security.javascriptEnabled para cada mongod y mongos en el clúster.

spec.processArgs.minimumEnabledTlsProtocol

Tipo: entero

Opcional

String que indica la versión mínima de TLS que el clúster acepta para las conexiones entrantes. Los clústeres que funcionan con TLS 1.0 o 1.1 deberían considerar establecer TLS 1.2 como la versión mínima del protocolo TLS.

Para aprender más, consulte ¿Qué versiones de TLS admite Atlas?.

Esta opción corresponde a la net.ssl.disabledProtocols mongod opción del archivo de configuración.

spec.processArgs.noTableScan

Tipo: booleano

Opcional

Indicador que señala si el clúster desactiva la ejecución de cualquier query que requiera un escaneo de colección para devolver resultados.

Esta opción corresponde al parámetro notablescan mongod.

spec.processArgs.oplogSizeMB

Tipo: entero

Opcional

Número que indica el límite de almacenamiento del registro de operaciones de un clúster, expresado en megabytes. Un valor de null indica que el clúster utiliza el tamaño predeterminado del registro de operaciones calculado por Atlas.

Esta opción corresponde a la replication.oplogSizeMB mongod opción del archivo de configuración.

spec.processArgs.sampleRefreshIntervalBIConnector

Tipo: entero

Opcional

Número que indica los documentos por base de datos que se deben muestrear al recopilar información de esquemas.

Este parámetro corresponde a la opción sampleSize mongosqld.

spec.processArgs.sampleSizeBIConnector

Tipo: entero

Opcional

Número que indica el intervalo en segundos en el que el proceso mongosqld vuelve a muestrear los datos para crear su esquema relacional.

Este parámetro corresponde a la opción sampleRefreshIntervalSecs mongosqld.

spec.projectRef.name

Tipo: string

Condicional

Nombre del proyecto al que pertenece la implementación. Debe especificar un recurso personalizado existente. Este parámetro solo se aplica a las implementaciones que pertenecen a proyectos administrados por la misma instancia del operador de Kubernetes de AtlasProject Atlas.

Para implementaciones que pertenecen a proyectos administrados por:

• una instancia diferente de Atlas Kubernetes Operator

• herramientas distintas de Atlas Kubernetes Operator

usar spec.externalProjectRef.id.

spec.serverlessSpec

Tipo: arreglo

Condicional

Nota

Consulta Notas de la Transición hacia Clústeres Flex para obtener información completa sobre los cambios.

Lista que contiene los parámetros de la instancia sin servidor de la API. Para ver una lista completa de los parámetros disponibles, consulte la API Flex Clustersde Atlas.

Importante

Debe especificar spec.deploymentSpec o spec.flexSpec en su configuración.

spec.upgradeToDedicated

Tipo: booleano

Opcional

Bandera que, cuando se establece en true, activa una actualización local de un clúster Flex a un clúster dedicado.

Si se omite, el valor por defecto es false. Para obtener una guía completa sobre el proceso de migración, consulta Migrar un clúster Flex a un clúster Dedicado.

Importante

También deberá proporcionar la configuración completa para el clúster dedicado de destino en el bloque spec.deploymentSpec. Esta operación es unidireccional e irreversible.

spec.serverlessSpec.privateEndpoints

Tipo: arreglo

Opcional

Nota

Atlas ha desaprobado los clústeres M2 y M5 y las instancias sin servidor. Atlas migró todos los clústeres M2 y M5 a clústeres Flex. Para instancias sin servidor, Atlas migró instancias a clústeres gratuitos, clústeres Flex o clústeres dedicados según su uso.

Para preservar la compatibilidad con versiones anteriores de las API durante un tiempo, Atlas seguirá permitiendo que estos clústeres migrados se administren mediante las mismas API (antiguas y nuevas), incluso al usar Atlas Kubernetes Operator. La compatibilidad con versiones anteriores de las API se mantendrá hasta enero de 2026, fecha en la que se eliminarán las API antiguas y solo se mantendrán las API relacionadas con los clústeres Flex.

El soporte para nodos privados en instancias sin servidor finalizó en marzo 2025. Debes actualizar la configuración de tu Atlas Kubernetes Operator para eliminar los nodos privados antes de marzo 2025. Debe remover todas las funcionalidades restantes de M2, M5 y de instancias sin servidor de sus configuraciones de Atlas Kubernetes Operator antes del 2026 de enero.

Si tus cargas de trabajo requieren nodos privados o copia de seguridad continua, cambia a Atlas clústeres dedicados. Para obtener más información, consulta Migración a Clusters Flex y la Guía de migración de Atlas Flex.

Obsoleto. Remueve este parámetro si existe. Lista que contiene las configuraciones del nodo privado para la instancia sin servidor.

spec.serverlessSpec.providerSettings

Tipo: Objeto

Condicional

Nota

Consulta Notas de la Transición hacia Clústeres Flex para obtener información completa sobre los cambios.

Configuración que especifica los parámetros de los hosts proporcionados en los que se ejecuta MongoDB. Las opciones disponibles son específicas del proveedor de servicios en la nube. Para obtener más información, consulta las opciones de configuración de instancias sin servidor de AWS, GCP y Azure.

Si deseas crear o actualizar una instancia sin servidor, debes especificar esta configuración.

Importante

Las siguientes configuraciones están obsoletas y se eliminarán en una versión futura:

• spec.serverlessSpec.providerSettings.DiskIOPS

• spec.serverlessSpec.providerSettings.DiskTypeName

• spec.serverlessSpec.providerSettings.EncryptEBSVolume

• spec.serverlessSpec.providerSettings.InstanceSizeName

• spec.serverlessSpec.providerSettings.VolumeType

• spec.serverlessSpec.providerSettings.AutoScaling

Proporcionar valores para cualquiera de estas configuraciones no tiene ningún efecto.

spec.serverlessSpec.providerSettings.providerName

Tipo: string

Condicional

Nota

Consulta Notas de la Transición hacia Clústeres Flex para obtener información completa sobre los cambios.

Proveedor de servicios en la nube en el que Atlas proporciona el host para una instancia sin servidor.

Atlas acepta los siguientes valores:

AWS	Amazon AWS
GCP	Google Cloud Platform
Azure	Microsoft Azure

spec.serverlessSpec.providerSettings.regionName

Tipo: string

Condicional

Nota

Consulta Notas de la Transición hacia Clústeres Flex para obtener información completa sobre los cambios.

Ubicación física de tu instancia sin servidor de MongoDB. La región que elija puede afectar la latencia de red para los clientes que acceden a sus bases de datos.

Para obtener una lista completa de los valores de los nombres de región, consulta las páginas de referencia del proveedor de nube:

• AWS

• GCP

• Azure

spec.serverlessSpec.tags

Nota

Consulta las Notas sobre la transición a Flex clústeres para obtener información completa sobre los cambios.

Tipo: arreglo

Opcional

Lista que contiene etiquetas (pares clave-valor) para entender mejor, organizar e identificar tus implementaciones de la base de datos. Para obtener más información, consulta Etiquetas en clusters.

status.connectionStrings

Tipo: arreglo

Requerido

Lista que contiene las URL de conexión para acceder al clúster. Este parámetro aparece después de crear o actualizar un clúster.

Nota

.. incluir:: /incluye/fact-ak8so-connection-strings.rst

Para consultar los parámetros de configuración disponibles para un clúster desde la API, consulta la API Clusters de Atlas.