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

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

Puede encontrar la configuración de su clúster Flex en el recurso AtlasDeployment administrado 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 un indicador booleano que, al establecerse en true, inicia una actualización local de un clúster Flex a un clúster Dedicado.

En el bloque spec.deploymentSpec, proporcione la configuración completa del 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.

Utilice el mismo nombre para su clúster dedicado que para su clúster Flex original.

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

Aplique el cambio a su 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

Supervisar 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 de la siguiente manera:

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 completada la migración, la condición DeploymentReady se actualiza 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 salida después de completar la actualización. Si la migración falla, la condición DeploymentReady muestra un mensaje de error y Reason. Si ya migró el clúster a un clúster dedicado, no cambia nada.

Limpieza después de la migración.

Una vez completada la migración, puede eliminar la marca upgradeToDedicated de su recurso AtlasDeployment y aplicarla de nuevo. Este paso es opcional, pero se recomienda para mantener la configuración limpia y evitar que la migración se reactive accidentalmente.

El recurso final AtlasDeployment se parece al 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.

Ha migrado correctamente su clúster Flex a un clúster dedicado. Su clúster ahora es una instancia dedicada M10. Adminístrelo como un clúster dedicado con el operador de Kubernetes de Atlas. Las cadenas de conexión de su aplicación ahora apuntan al nuevo clúster dedicado.