AtlasDeployment Recurso personalizado

Migración a clústeres flexibles

Cambios importantes con el operador Atlas Kubernetes 2.0

Acerca del recurso personalizado AtlasDeployment

El recurso personalizado AtlasDeployment configura su clúster MongoDB o Flex en Atlas. Al crear el recurso personalizado AtlasDeployment, el operador de Kubernetes de Atlas intenta crear o actualizar un clúster o Flex en Atlas.

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

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

• Si especifica valores para los campos en, Atlas Kubernetes spec.flexSpec Operator utiliza el recurso de API de instancia Flex de Atlas 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.

Puede ejecutar el siguiente comando para comprobar el estado:

kubectl get atlasdeployment -o yaml

El siguiente ejemplo muestra la sección de estado de un clúster que se está aprovisionando:

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 obtener una lista completa de los parámetros disponibles para los clústeres, consulte 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.

Consulte Notas sobre la transición a clústeres flexibles para obtener información completa sobre los cambios.

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

spec.backupRef

Tipo: objeto

Opcional

Lista que contiene los detalles del AtlasBackupSchedule recurso personalizado que desea aplicar. Puede especificar una programación 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.connectionSecret.name

Tipo: string

Condicional

Nombre del secreto opacoQue 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 del padre 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

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

Consulte Notas sobre la transición a clústeres flexibles para obtener información completa sobre los cambios.

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á implementando conjuntos de réplicas no globales y clústeres fragmentados.	Opcional

Atlas acepta:

Valor	Tipo de clúster
RÉPLICASET	set de réplicas
FRAGUADO	clúster fragmentado
GEOSHARDED	clúster global

spec.deploymentSpec.customZoneMapping

Tipo: arreglo

Requerido

Lista que contiene parámetros de clúster global que asignan zonas a regiones geográficas. Para obtener una lista completa de los parámetros disponibles, consulte la API de clústeres globales de Atlas.

spec.deploymentSpec.customZoneMapping.location

Tipo: string

Requerido

Código que representa una ubicación que se asigna a una zona de 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 añadir capacidad, hasta un valor máximo posible de 4096 (4 TB). Debe especificar un número positivo para este valor.

No se puede establecer este valor para clústeres con SSD NVMe locales.

Nota

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

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 utilizará el valor mínimo de disco de forma predeterminada.

Si su implementación de base de datos incluye nodos de Azure, este valor debe corresponder a un tipo de disco de Azure existente (,,,,,,,,8 16326412825651210242048 4096o).

Atlas calcula los cargos de almacenamiento de manera diferente dependiendo de si elige el valor predeterminado o un valor personalizado.

Atlas tiene límites de capacidad de disco en conjuntos de réplicas individuales, que se pueden escalar hasta 4 TB para niveles de clúster superiores. Para ampliar el almacenamiento total del clúster más allá de los límites predeterminados, puede habilitar el almacenamiento extendido en la configuración del proyecto. Para permitir un mayor escalamiento en el futuro, le recomendamos habilitar la fragmentación para la expansión a largo plazo.

Si la implementación de su base de datos abarca proveedores de servicios en la nube, este valor predeterminado es el valor mínimo predeterminado de los proveedores involucrados.

Para obtener más información, consulte 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
AZUR	Microsoft Azure
NINGUNO	Sin proveedor; el clúster no cifra datos utilizando claves administradas por el cliente.

spec.deploymentSpec.managedNamespaces

Tipo: arreglo

Requerido

Lista que contiene información para crear un espacio de nombres administrado en un clúster global específico. Para obtener una lista completa de los parámetros disponibles, consulte la 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 fragmento personalizada para la colección especificada. Este parámetro tiene el valor predeterminado false.

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

• Establézcalo en false para deshabilitar una clave de fragmento personalizada para la colección. Si está deshabilitada, MongoDB usa fragmentación por rango.

Para obtener más información, consulte Claves de fragmentos con hash.

spec.deploymentSpec.managedNamespaces.isCustomShardKeyUnique

Tipo: booleano

Opcional

Indicador que indica si la clave de fragmento personalizada de la colección especificada es única. Este parámetro tiene el valor predeterminado false.

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

• Establezca en false para deshabilitar una clave de fragmento personalizada única 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 Fragmentar una colección global.

spec.deploymentSpec.managedNamespaces.presplitHashedZones

Tipo: booleano

Opcional

Indicador que indica si MongoDB Cloud debe crear y distribuir fragmentos iniciales para una colección vacía o inexistente. Este parámetro tiene el valor predeterminado false.

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

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

spec.deploymentSpec.mongoDBMajorVersion

Tipo: string

Opcional

Versión del clúster que se va a implementar. Atlas admite 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 posterior.
Usted especifica este parámetro.	Atlas siempre implementa el clúster con la última versión del parche estable de la versión especificada.
Establece el parámetro spec.deploymentSpec.versionReleaseSystem en.CONTINUOUS	Debes omitir este parámetro.

spec.deploymentSpec.pitEnabled

Tipo: booleano

Condicional

Nota

Atlas dejó obsoletos los clústeres M2 y M5 y las instancias sin servidor. Próximamente, Atlas migrará automáticamente todos los clústeres M2 y M5 a clústeres Flex. Para las instancias sin servidor, Atlas determinará si migrará las instancias a clústeres gratuitos, Flex o dedicados según su uso y, luego, migrará automáticamente las instancias sin servidor.

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.

La compatibilidad con endpoints privados en instancias sin servidor finalizará en marzo del 2025. Debe actualizar sus configuraciones de Operador de Kubernetes de Atlas para eliminar los endpoints privados antes del 2025 ​​de marzo. Debe eliminar todas las funciones restantes de M2, M5 y de instancias sin servidor de sus configuraciones de Operador de Kubernetes de Atlas antes del 2026 de enero.

Si sus cargas de trabajo requieren puntos de conexión privados o copias de seguridad continuas y restauración a un punto en el tiempo, cambie a clústeres dedicados de Atlas. Para obtener más información, consulte Migración a clústeres Flex y la Guía de migración de Atlas Flex.

Configuración que permite la copia de seguridad continua en la nube. Para habilitarla, debe especificar true en esta configuración.

spec.deploymentSpec.replicationSpecs

Tipo: matriz 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 de la matriz representa una zona donde Atlas implementa los nodos de su clúster.
Está implementando conjuntos de réplicas no globales y clústeres fragmentados.	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 spec.deploymentSpec.replicationSpecs.numShardsy.

spec.deploymentSpec.replicationSpecs.numShards

Tipo: entero

Condicional

Entero positivo que especifica la cantidad de fragmentos a implementar para un clúster fragmentado.

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

Atlas acepta valores de 1 a 50, ambos inclusive. El valor predeterminado es 1.

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

• Si especifica 1 y spec.deploymentSpec.clusterType establece REPLICASET en, Atlas implementa un conjunto 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

Al usar un clúster fragmentado, MongoDB requiere que sus aplicaciones se conecten a una mongos instancia para garantizar que interactúen correctamente con los fragmentos y otros componentes del clúster. Si migra de un conjunto de réplicas a un clúster fragmentado, sus aplicaciones deben reiniciarse para habilitar la conexión con la instancia del mongos clúster. Por lo tanto, la API de administración de Atlas impide migrar un conjunto de réplicas directamente a un clúster fragmentado con más de un fragmento. Después de migrar correctamente su conjunto de réplicas a un clúster de un solo fragmento y restablecer las conexiones de sus aplicaciones, puede agregar fragmentos 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 consultas de informes de BI Connector for Atlas. Son de solo lectura y nunca pueden convertirse en el nodo principal.

Si no especifica este parámetro, Atlas no implementará ningún 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.

• Establezca en true para habilitar el escalamiento automático del disco.

• Establezca en false para deshabilitar el escalamiento automático del disco.

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

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

Tipo: booleano

Opcional

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

• Establezca true para habilitar el escalado automático del tamaño de la instancia. Si está habilitado, debe especificar un valor spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize para.

• Establezca en false para deshabilitar el escalamiento automático del tamaño de la instancia.

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

Tipo: string

Condicional

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

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 usted 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 la instancia actual y usted no cambia 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 establece un tamaño de instancia mínimo mayor 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ínimo que especifique.

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

Si Atlas cambia el tamaño de la instancia actual y usted no cambia 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 implementa un clúster fragmentado o un clúster global, debe elegir un tamaño de instancia de M30 o mayor.

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

Nota

Si tiene habilitado el escalado automático para el campo de cálculo, no podrá editar esta opción. Para obtener más información,spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled consulte.

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 spec.deploymentSpec.replicationSpecs.regionConfigs.priority si 0 es.

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, configure este valor en 0.

Si tiene varios objetos regionConfigs (su clúster es multirregión o multinube), deben tener prioridades en orden descendente. La prioridad más alta es 7.

Ejemplo

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

Si su región ha establecido electableSpecs.nodeCount en 1 o superior, debe tener una prioridad exactamente igual a una región menor que otra en la replicationSpecs.regionConfigs matriz, a menos que sea la principal. La región con mayor prioridad debe tener una prioridad 7 de. La prioridad más baja posible 1 es.

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 tiene tres regiones, sus prioridades serían 7, 6 y 5, respectivamente. Si añadiera dos regiones más para admitir nodos elegibles, sus prioridades 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
AZUR	Microsoft Azure

spec.deploymentSpec.replicationSpecs.regionConfigs.regionName

Tipo: string

Condicional

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

Para obtener una lista completa de los valores de los nombres de las regiones, consulte las páginas de referencia del proveedor de la nube:

• AWS

• GCP

• Azure

Para clústeres multirregionales, consulte. Debe spec.deploymentSpec.replicationSpecs configurar spec.deploymentSpec.replicationSpecs.regionConfigs.regionName spec.deploymentSpec.replicationSpecso.

spec.deploymentSpec.replicationSpecs.regionConfigs.readOnlySpecs

Tipo: objeto

Opcional

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

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

spec.deploymentSpec.replicationSpecs.zoneName

Tipo: string

Opcional

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

spec.deploymentSpec.searchIndexes

Tipo: arreglo

Opcional

Una matriz 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 que identifica este índice. Debe ser única 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 notiene una, cree una.
collectionName	string	Etiqueta legible por humanos que identifica la colección que contiene uno o más índices de Atlas Search.
type	string	Tipo de índice. Atlas acepta los siguientes valores: search vectorSearch
search	Objeto	Debe incluir este objeto si type es search. De lo contrario, omítalo.
vectorSearch	Objeto	Debe incluir este objeto si type es vectorSearch. De lo contrario, omítalo.

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, que se describe a continuación. Requerido

spec.deploymentSpec.searchIndexes.search.synonyms

Tipo: arreglo

Opcional

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

Campo	Tipo	Descripción
name	string	Etiqueta legible que identifica la definición del sinónimo. Cada nombre debe ser único dentro de la misma definición del í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.estándar lucene.estándar lucene.simple lucene.whitespace lucene.keyword lucene.arabic lucene.armenio lucene.basque lucene.bengalí lucene.brasileño lucene.búlgaro lucene.catalán lucene.chino lucene.cjk lucene.checo lucene.danés lucene.dutch lucene.inglés lucene.finnish lucene.francés lucene.gallego lucene.alemán lucene.griego lucene.hindi lucene.húngaro lucene.indonesio lucene.irlandés lucene.italiano lucene.japonés lucene.korean lucene.kuromoji lucene.letón lucene.lituano lucene.morfologik lucene.nori lucene.noruego lucene.persa lucene.portugués lucene.rumano lucene.ruso lucene.smartcn lucene.sorani lucene.español lucene.sueco lucene.thai lucene.turco lucene.ucraniano Requerido
source	Objeto	Conjunto de datos que almacena la correspondencia entre una o más palabras y 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 indica si el índice utiliza asignaciones dinámicas o estáticas. Obligatorio si se omite mappings.fields.
fields	JSON/YAML	Una o más especificaciones de campo para el índice de búsqueda de Atlas. Obligatorio si mappings.dynamic se omite o se establece como falso.

spec.deploymentSpec.searchIndexes.vectorSearch

Tipo: objeto

Opcional

Campo	Tipo	Descripción
fields	JSON/YAML	Matriz de objetos JSON. Ver 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 de 2 a 32, ambos inclusive. El valor predeterminado es 2.
instanceSize	string	Especificación de hardware para el tamaño de las instancias de nodo de búsqueda. Atlas acepta una de las siguientes opciones: 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 comprender, organizar e identificar mejor las implementaciones de bases de datos. Para obtener más información, consulte Etiquetas en clústeres.

spec.deploymentSpec.terminationProtectionEnabled

Tipo: booleano

Indica si la protección de terminación está habilitada o deshabilitada para el clúster. 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.deploymentSpec.versionReleaseSystem

Tipo: string

Condicional

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

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

• LTSAtlas crea su clúster con la última versión de parche de MongoDB que especifique en el spec.deploymentSpec.mongoDBMajorVersion parámetro. Atlas actualiza automáticamente su clúster con las siguientes versiones de parche de esta versión de MongoDB. Atlas no actualiza su clúster con las nuevas versiones rápidas o principales 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 spec.deploymentSpec.mongoDBMajorVersion parámetro.

spec.externalProjectRef.id

Tipo: string

Condicional

ID del proyecto al que pertenece la implementación. Debe especificar el ID de proyecto de un proyecto Atlas existente. Este parámetro es obligatorio para las implementaciones que pertenecen a proyectos gestionados por:

• Una instancia diferente de Atlas Kubernetes Operator

• Herramientas distintas a Atlas Kubernetes Operator

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

spec.flexSpec

Tipo: arreglo

Condicional

Nota

Consulte Notas sobre la transición a clústeres flexibles 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

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

spec.flexSpec.name

Tipo: string

Cadena que identifica el nombre del clúster Flex.

spec.flexSpec.tags

Tipo: arreglo

Opcional

Lista que contiene etiquetas (pares clave-valor) para comprender, organizar e identificar mejor las implementaciones de bases de datos. Para obtener más información, consulte Etiquetas en clústeres.

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 las regiones, consulte las páginas de referencia del proveedor de la 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

Cadena que indica el nivel predeterminado de reconocimiento solicitado a MongoDB para las operaciones de lectura establecidas para este clúster.

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

spec.processArgs.defaultWriteConcern

Tipo: string

Opcional

Cadena que indica el nivel predeterminado de reconocimiento solicitado a MongoDB para las operaciones de escritura establecidas para este clúster.

Las versiones y posteriores de MongoDB tienen como valor predeterminado 5.0 la mayoría de los clústeres.

spec.processArgs.failIndexKeyTooLong

Tipo: booleano

Opcional

Marca que indica si se debe fallar la operación y devolver un error al insertar o actualizar documentos cuyas entradas indexadas superen 1024 bytes. Si se establece false en, escribe los documentosmongod que superen este límite, pero no los indexa.

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

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 security.javascriptEnabled opción del archivo de configuración para cada mongod y en el mongos clúster.

spec.processArgs.minimumEnabledTlsProtocol

Tipo: entero

Opcional

Cadena que indica la versión mínima de TLS que el clúster acepta para las conexiones entrantes. Los clústeres que usan TLS 1.0 o 1.1 deberían considerar configurar 1TLS.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

Bandera que indica si el clúster deshabilita la ejecución de cualquier consulta que requiera un escaneo de colección para devolver resultados.

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

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 a muestrear al momento de recopilar información del esquema.

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 mongosqld sampleRefreshIntervalSecs.

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

utilice spec.externalProjectRef.id.

spec.serverlessSpec

Tipo: arreglo

Condicional

Nota

Consulte Notas sobre la transición a clústeres flexibles 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.serverlessSpec.privateEndpoints

Tipo: arreglo

Opcional

Nota

Atlas dejó obsoletos los clústeres M2 y M5 y las instancias sin servidor. Próximamente, Atlas migrará automáticamente todos los clústeres M2 y M5 a clústeres Flex. Para las instancias sin servidor, Atlas determinará si migrará las instancias a clústeres gratuitos, Flex o dedicados según su uso y, luego, migrará automáticamente las instancias sin servidor.

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.

La compatibilidad con endpoints privados en instancias sin servidor finalizará en marzo del 2025. Debe actualizar sus configuraciones de Operador de Kubernetes de Atlas para eliminar los endpoints privados antes del 2025 ​​de marzo. Debe eliminar todas las funciones restantes de M2, M5 y de instancias sin servidor de sus configuraciones de Operador de Kubernetes de Atlas antes del 2026 de enero.

Si sus cargas de trabajo requieren puntos de conexión privados o copias de seguridad continuas y restauración a un punto en el tiempo, cambie a clústeres dedicados de Atlas. Para obtener más información, consulte Migración a clústeres Flex y la Guía de migración de Atlas Flex.

Obsoleto. Elimine este parámetro si existe. Lista que contiene las configuraciones de endpoints privados para la instancia sin servidor.

spec.serverlessSpec.providerSettings

Tipo: Objeto

Condicional

Nota

Consulte Notas sobre la transición a clústeres flexibles para obtener información completa sobre los cambios.

Configuración que especifica la configuración de los hosts aprovisionados donde se ejecuta MongoDB. Las opciones disponibles son específicas del proveedor de servicios en la nube. Para obtener más información, consulte las opciones de configuración de instancias de AWS, GCP y Azure Serverless.

Si desea crear o actualizar una instancia sin servidor, debe 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

Consulte Notas sobre la transición a clústeres flexibles para obtener información completa sobre los cambios.

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

Atlas acepta los siguientes valores:

AWS	Amazon AWS
GCP	Google Cloud Platform
AZUR	Microsoft Azure

spec.serverlessSpec.providerSettings.regionName

Tipo: string

Condicional

Nota

Consulte Notas sobre la transición a clústeres flexibles para obtener información completa sobre los cambios.

Ubicación física de su instancia de MongoDB Serverless. 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 las regiones, consulte las páginas de referencia del proveedor de la nube:

• AWS

• GCP

• Azure

spec.serverlessSpec.tags

Nota

Consulte Notas sobre la transición a clústeres flexibles para obtener información completa sobre los cambios.

Tipo: arreglo

Opcional

Lista que contiene etiquetas (pares clave-valor) para comprender, organizar e identificar mejor las implementaciones de bases de datos. Para obtener más información, consulte Etiquetas en clústeres.

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 conocer los parámetros de configuración disponibles para un clúster desde la API, consulte la API de clústeres Atlas.