Migrar um cluster flexível para um cluster dedicado

Encontre a configuração do cluster Flex que você deseja atualizar.

Você pode encontrar sua configuração de cluster flexível no recurso AtlasDeployment gerenciado pelo Atlas Kubernetes Operator.

O exemplo a seguir mostra uma configuração de cluster Flex no Amazon Web Services na região 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

Adicione o campo spec.upgradeToDedicated e a configuração completa para o cluster dedicado de destino.

Adicione o campo spec.upgradeToDedicated ao seu recurso AtlasDeployment. Este campo é uma bandeira booleana que, quando configurado para true, inicia uma atualização no local de um cluster Flex para um cluster Dedicado.

No bloco spec.deploymentSpec, forneça a configuração completa para o cluster dedicado de destino. Isso inclui detalhes como provedor, região, tamanho da instância e quaisquer outros parâmetros necessários.

Use o mesmo nome para seu cluster Dedicado que seu cluster Flex original.

O exemplo a seguir mostra como modificar a configuração do cluster Flex para iniciar a migração para um cluster 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 a alteração ao seu cluster Kubernetes.

Use o comando kubectl apply para aplicar as alterações em seu cluster Kubernetes.

kubectl apply -f my-cluster.yaml

Monitore o processo de migração.

O Atlas Kubernetes Operator inicia imediatamente o processo de migração. Você pode monitorar o progresso usando o comando kubectl describe.

kubectl describe atlasdeployment my-flex-cluster

Inicialmente, a condição DeploymentReady aparece como o seguinte:

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

Depois que a migração for concluída, a condição DeploymentReady será atualizada para:

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

Você também vê um evento Normal no resultado após a conclusão da atualização. Se a migração falhar, a condição DeploymentReady mostrará uma mensagem de erro e o Reason. Se você já migrou o cluster para cluster dedicado, nada mudará.

Limpeza após a migração.

Após a migração ser concluída, você poderá remover o sinalizador upgradeToDedicated do seu recurso AtlasDeployment e aplicá-lo novamente. Esta etapa é opcional, mas recomendada para manter sua configuração limpa e evitar o novo acionamento acidental da migração.

O recurso final AtlasDeployment é parecido com o exemplo a seguir :

# 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

Migração concluída.

Você migrou com sucesso seu cluster Flex para um cluster Dedicado. Seu cluster agora é uma instância de cluster dedicado M10. Gerencie-o como um cluster dedicado usando o Atlas Kubernetes Operator. As connection strings do seu aplicação agora ponto para o novo cluster dedicado.