Migra un clúster Flex a un clúster dedicado

Atlas Kubernetes Operator admite la migración de un clúster Flex a un clúster Dedicado en el mismo lugar. Esto permite escalar la infraestructura de la base de datos directamente desde el entorno Kubernetes.

Requisitos previos

Antes de comenzar, debes tener lo siguiente:

Un nivel de clúster Flex existente AtlasDeployment administrado por Atlas Kubernetes Operator.
Permisos para modificar el recurso de nivel de clúster Flex AtlasDeployment en su clúster de Kubernetes.
Facturación habilitada para tu proyecto de Atlas. Actualizar resultará en cargos a tu cuenta de Atlas.

Procedimiento

Busque la configuración del clúster de Flex que desea actualizar.

Puedes encontrar tu configuración del clúster Flex en el recurso de AtlasDeployment gestionado por Atlas Kubernetes Operator.

El siguiente ejemplo muestra una configuración de clúster Flex en AWS en la región us-east-1.

# my-cluster.yaml
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
   name: my-flex-cluster
spec:
   projectRef:
      name: my-atlas-project
   flexSpec:
      name: my-cluster
      providerSettings:
         backingProviderName: AWS
         regionName: US_EAST_1

Añade el campo `spec.upgradeToDedicated` y la configuración completa para el clúster Dedicado de destino.

Agregue el campo spec.upgradeToDedicated a su recurso AtlasDeployment. Este campo es una bandera booleana que, cuando se establece en true, inicia una actualización en el lugar de un clúster Flex a un clúster Dedicado.

En el bloque spec.deploymentSpec, proporcione la configuración completa para el clúster dedicado de destino. Esto incluye detalles como el proveedor, la región, el tamaño de la instancia y cualquier otro parámetro necesario.

Utiliza el mismo nombre para tu clúster dedicado que para el clúster Flex original.

Nota

Si usas un nombre diferente para el clúster dedicado, la migración falla.

El siguiente ejemplo muestra cómo modificar la configuración del clúster Flex para iniciar la migración a un clúster Dedicado.

# my-cluster.yaml
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  # The name MUST remain the same
  name: my-flex-cluster
spec:
  projectRef:
    name: my-atlas-project
  # Add the upgrade flag
  upgradeToDedicated: true
  # Add the full configuration for the target Dedicated-cluster
  deploymentSpec:
      name: "my-cluster" # The name MUST remain the same
      clusterType: REPLICASET
      backupEnabled: true
      replicationSpecs:
         - regionConfigs:
            - providerName: AWS
              regionName: US_EAST_1
              priority: 7
              electableSpecs:
                 instanceSize: M10
                 nodeCount: 3

Aplica el cambio a tu clúster de Kubernetes.

Utiliza el comando kubectl apply para aplicar los cambios a tu clúster de Kubernetes.

kubectl apply -f my-cluster.yaml

Supervisa el proceso de migración.

El operador de Kubernetes de Atlas inicia inmediatamente el proceso de migración. Puede supervisar el progreso con el comando kubectl describe.

kubectl describe atlasdeployment my-flex-cluster

Inicialmente, la condición DeploymentReady aparece como la siguiente:

Status:
   Conditions:
     ...
     - Last Transition Time:  2025-06-18T10:00:00Z
       Message:             Cluster upgrade to dedicated instance initiated in Atlas...
       Reason:              FlexToDedicatedMigrationProgressing
       Status:              "False"
       Type:                DeploymentReady

Una vez que se complete la migración, la condición DeploymentReady se actualizará a:

Status:
   Conditions:
      ...
      - Last Transition Time:  2025-06-18T10:15:00Z
        Message:             Cluster upgrade successful. You can now remove the 'upgradeToDedicated' flag from the spec.
        Status:              "True"
        Type:                DeploymentReady

También verá un evento Normal en la entrada después de completarse la actualización. Si la migración falla, la condición DeploymentReady muestra un mensaje de error y la Reason. Si ya migró el clúster a Clúster dedicado, nada cambia.

Limpieza después de la migración.

Cuando finalice la migración, puede remover el flag upgradeToDedicated del recurso AtlasDeployment y volver a aplicarlo. Este paso es opcional, pero se recomienda para mantener la configuración limpia y evitar que la migración se active nuevamente accidentalmente.

El recurso final AtlasDeployment se ve como el siguiente ejemplo:

# my-cluster.yaml
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-flex-cluster
spec:
  projectRef:
    name: my-atlas-project
  deploymentSpec:
      name: "my-cluster" # The name MUST remain the same
      clusterType: REPLICASET
      backupEnabled: true
      replicationSpecs:
         - regionConfigs:
            - providerName: AWS
              regionName: US_EAST_1
              priority: 7
              electableSpecs:
                 instanceSize: M10
                 nodeCount: 3

Migración completada.

Has migrado con éxito tu clúster Flex a un clúster dedicado. Tu clúster ahora es una instancia de clúster dedicado M10. Gestionarlo como un clúster dedicado utilizando el Atlas Kubernetes Operator. Las cadenas de conexión de tu aplicación ahora apuntan al nuevo clúster dedicado.

Overview