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 en spec.flexSpec, Atlas Kubernetes Operator utiliza el recurso API de instancia flexible de Atlas para crear un nuevo clúster flexible o actualizar un clúster flexible existente.

Crear un clúster gratuito tarda 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, consulta la API de clústeres Flexde 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 AtlasBackupSchedule Recurso Personalizado para el cronograma de copia de seguridad que se desea aplicar. Puedes especificar solo un cronograma de copia de seguridad por clúster, pero puedes usar el mismo cronograma de copia de seguridad 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

String que indica el espacio de nombres que contiene el AtlasBackupSchedule Recurso Personalizado para la programación de copia de seguridad que deseas 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_DEDICATEDEl 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 secreto opaco que contiene el Identificador de la Organización y claves de API que Atlas Kubernetes Operator utiliza para conectarse a Atlas. Si no se especifica, el Atlas Kubernetes Operator volverá a lo siguiente:

• 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 CRD independientes.

spec.deploymentSpec

Tipo: arreglo

Condicional

Lista que contiene los parámetros del clúster desde la API. Para obtener una lista completa de los parámetros disponibles, consulta 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 que se va a crear.

¿Cuándo debe usar este parámetro?

Condición	Necesidad
Establece 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
particionado	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 para humanos que identifica la zona en tu 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 se puede configurar este valor para clústeres con unidades SSD NVMe locales.

Nota

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

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

Si su 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 gestiona la clave del cliente para este clúster. Debes configurar este valor para habilitar el cifrado en reposo utilizando claves gestionadas por el cliente para este clúster, lo que proporciona una capa adicional de cifrado. Para obtener más información, consulta Cómo cifrar datos utilizando un Key Management Service.

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 para 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 a gestionar 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.

• Definir en true para activar una clave de partición 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 partición 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.

• Configura true para que MongoDB Nube cree y distribuya los fragmentos iniciales en una colección vacía o que no exista.

• 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
Usted 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 en LTS.	Atlas implementa un clúster que ejecuta MongoDB 7.0.
Atlas ha dejado de admitir clústeres de M2 y M5 y instancias sin servidor. Para obtener más información, consulte migración a clúster Flex. Establezca el parámetro spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize en M0, M2 o M5.	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 establecido el spec.deploymentSpec.versionReleaseSystem parámetro 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 periodo de tiempo, Atlas continuará permitiendo que estos clústeres migrados sean gestionados mediante las mismas API (antiguas y nuevas API), incluso al usar Atlas Kubernetes Operator. La compatibilidad hacia atrás de las API se mantendrá vigente hasta enero 2026, cuando se eliminarán las API antiguas y solo permanecerán vigentes 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 de las regiones de su clúster. Utilice este parámetro para clústeres multiregionales. Debe establecer spec.deploymentSpec.replicationSpecs.regionConfigs.regionName o spec.deploymentSpec.replicationSpecs.

¿Cuándo debe usar 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 especifica este parámetro, también debe 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 de una sola partición.

• 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 utiliza un clúster particionado, MongoDB requiere que sus aplicaciones se conecten a una mongos instancia para garantizar que sus aplicaciones tengan interacción correcta con las particiones y otros componentes del clúster particionado. Si migra de un set de réplicas a un clúster particionado, sus aplicaciones deben reiniciarse para habilitar la conexión al clúster mongos. Como resultado, la API de administración de Atlas le impide migrar un set de réplicas directamente a un clúster particionado con más de una partición. Después de migrar correctamente su set de réplicas a un clúster de una sola partición y restablecer las conexiones de su aplicación, puede añadir particiones adicionales al clúster.

spec.deploymentSpec.replicationSpecs.regionConfigs

Tipo: arreglo

Requerido

Especificaciones de hardware para nodos configurados para una región dada. Cada objeto regionConfigs describe la prioridad de la región en las elecciones y el número y tipo de nodos MongoDB que Atlas despliega en la región.

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

• M0Los clústeres, M2, o M5 requieren solo 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 permite saber si esta implementación de la base de datos habilita el escalado automático de disco. Este parámetro tiene un valor por defecto de 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 muestra si el escalado automático del tamaño de la instancia está habilitado. Este parámetro tiene un valor por defecto de 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 establece spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled en true.

Nota

Si configuras un tamaño máximo de instancia más pequeño que el tamaño de instancia actual de la implementación de la base de datos con el escalado automático habilitado, Atlas escalará automáticamente el tamaño de instancia actual al valor máximo que especifiques.

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). Debe especificar este parámetro si establece 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 primarios y habilitar lecturas locales.

Si no especifica esta opción, Atlas no implementa ningún nodos elegibles a 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 por defecto. El tamaño de instancia que selecciones se aplica a todos los hosts de datos en tu tamaño de instancia. Para obtener más información, consulte los tamaños de almacenamiento personalizado de AWS, GCP y Azure.

Si implementa un clúster particionado, o clúster global, debe elegir un tamaño de instancia de M30 o superior.

Si cambias el nombre del tamaño de la instancia después de implementar tu clúster, Atlas cambiará la implementación de la base de datos al tamaño de instancia que especifiques a menos que esté fuera del rango que especifiques en spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize y spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize con escalado automático habilitado. Para aprender más, consulte 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 aprender más, consulte 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 para que Atlas los implemente en la región. Los nodos elegibles pueden convertirse en primarios 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 produce una elección primaria.

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 región de prioridad 7 identifica la Región preferida del clúster. Atlas coloca el nodo primario en la Región Preferida. Las prioridades 1 a 7 son exclusivas: 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. Debe establecer 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 del í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 predefinido específico elegido para aplicar a los sinónimos a buscar. 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 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.japonesa lucene.korean lucene.kuromoji lucene.latvian lucene.lithuanian lucene.morfologik lucene.nori lucene.norwegian lucene.persian lucene.portuguese lucene.romanian lucene.russian lucene.smartcn lucene.sorani lucene.español lucene.swedish lucene.thai lucene.turkish 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

Un arreglo 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 por defecto de la instancia 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.

• LTS: Atlas crea su clúster utilizando la última versión de parche de la versión de MongoDB que especifique en el spec.deploymentSpec.mongoDBMajorVersion parámetro. Atlas actualiza automáticamente su clúster a las siguientes versiones de parche de esta versión de MongoDB. Atlas no actualiza su clúster a las versiones rápidas o principales 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, consulta la Atlas API de Flex Clusters.

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 está configurado 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.flexSpec.providerSettings.backingProviderName

Tipo: string

El nombre del proveedor de nube para tu clúster Flex. providerSettings incluye la configuración que especifica los ajustes para los hosts provisionados 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 adicionales de configuración para tu 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 clústeres de MongoDB 5.0 están configurados por defecto en local.

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 para fallar la operación y devolver un error cuando se insertan o actualizan documentos donde todas las entradas de índice superan los 1024 bytes. Si lo establece en false, mongod guarda documentos que superan este límite, pero no los índice.

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 del 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 utilizan TLS 1.0 o 1.1 deben considerar la posibilidad de configurar 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 opción del archivo de configuración mongod.

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 oplog de un clúster expresado en megabytes. Un valor de null indica que el clúster utiliza el tamaño de oplog predeterminado que calcula Atlas.

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

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 AtlasProject Recurso personalizado existente. Este parámetro se aplica solo a las implementaciones que pertenecen a proyectos gestionados por la misma instancia del 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.

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 desde la API. Para obtener una lista completa de los parámetros disponibles, consulta la API de Flex Clustersde Atlas.

Importante

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

spec.upgradeToDedicated

Tipo: booleano

Opcional

Indicador que, cuando se establece en true, activa una actualización in situ 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 periodo de tiempo, Atlas continuará permitiendo que estos clústeres migrados sean gestionados mediante las mismas API (antiguas y nuevas API), incluso al usar Atlas Kubernetes Operator. La compatibilidad hacia atrás de las API se mantendrá vigente hasta enero 2026, cuando se eliminarán las API antiguas y solo permanecerán vigentes 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 ya no se recomiendan y serán eliminadas 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 que se crea o actualiza un clúster.

Nota

.. include:: /includes/fact-ak8so-connection-strings.rst

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