Migrar ao vivo (push) um Cluster Monitorado pelo Cloud Manager no Atlas

No Atlas, vá para o Migration Hub do seu projeto.

1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

2. Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.

3. Na barra lateral, clique em Migration sob o título Services.

O Hub de Migração é exibido.

Inicie o processo de migração.

1. Clique em Migrate from a Self-Managed MongoDB Database.

   Observação

   O rótulo da UI menciona o Ops Manager, no entanto, para esse procedimento, você só pode migrar clusters que executem o MongoDB 6.0 ou posterior para o Atlas que o Cloud Manager monitora.

2. Clique em I'm Ready to Start.

O Atlas exibe um assistente de migração em produção com instruções sobre como proceder com o processo. O processo envia os dados do cluster de origem para o novo cluster de destino. Depois de concluir as etapas do assistente, você poderá ponto sua aplicação para o novo cluster.

Vincular com o Atlas.

1. Clique em Generate Link-Token. O Atlas exibe a página para gerar um link-token.

2. Clique em Next para ver uma página que contém o link-token gerado.

3. Copie o link-token e armazene-o em um local seguro. O Atlas nunca exibe o conteúdo do link-token. O Atlas também não exibe o link-token após gerá-lo. Não o compartilhe publicamente.

   Observação

   Use um link-token exclusivo para migrar ao vivo todos os projetos em uma organização do Cloud Manager para o Atlas.

4. Clique em Done.

Cole o link-token no Cloud Manager.

1. Acessar a organização no Cloud Manager:

   Abra o Cloud Manager e navegue até a organização cujo cluster do projeto você está migrando em tempo real para o Atlas.

2. Clique em Settings no painel de navegação esquerdo.

3. Na seção Live Migration: Connect to Atlas , clique em Connect to Atlas. A caixa de diálogo Connect to Atlas aparece.

4. Cole o link-token que você gerou na etapa anterior do assistente de migração em produção e clique em Connect to Atlas. O Cloud Manager estabelece a conexão com o Atlas. Utilize o botão Refresh para enviar uma atualização para o Atlas, se necessário.

Criar o cluster do Atlas de destino.

If you haven't already, create a destination cluster in Atlas. See Required Access.

Inicie a migração do cluster de destino.

1. Clique em Select Target Cluster from Projects.

2. Vá para o projeto do seu Atlas cluster de destino e encontre seu cluster de destino.

3. Clique em e selecione Migrate Data to this Cluster na lista suspensa para iniciar a migração. A página Migrate Data to This Cluster abre.

4. Clique em Migrate from a Self-Managed MongoDB Database.

   Observação

   O rótulo da UI menciona o Ops Manager, no entanto, para esse procedimento, você só pode migrar para clusters do Atlas que executem o MongoDB 6.0 ou posterior para o Atlas que o Cloud Manager monitora.

   Preencha os campos da seguinte maneira:

   • Selecione o projeto de origem no Cloud Manager, se ainda não estiver selecionado.

   • Selecione o cluster de origem no menu suspenso.

   • Se você estiver migrando um conjunto de réplicas para um cluster fragmentado:

     • Se você quiser shard as coleções, clique na marca de seleção em Include sharding parameters e cole seu JSON de configuração de sharding na caixa de texto usando o exemplo de sharding. Salve esta configuração em um arquivo externamente, caso você precise consultá-la mais tarde.

       The sharding configuration JSON defines the shardingEntries array, which specifies the collections to shard, and the keys to use for sharding. MongoDB shards only those collections that you include into this array. To learn more, see Sharding.

       Se você omitir a especificação da configuração de fragmentação, poderá fragmentar as coleções no cluster de destino após migrar o cluster para o Atlas.

     • Além da configuração de fragmentação, um índice compatível para as chaves de fragmentação especificadas deve existir no cluster de destino em serviço.

       Marque a opção Create supporting indexes para que o MongoDB crie automaticamente índices de chaves de fragmento de suporte no cluster de destino no Atlas.

   • Selecione um host de migração para lidar com a migração.

   • Se você não estiver usando um private endpoint, revise a lista de acesso de endereço IP e verifique se o endereço IP externo do host de migração está incluído nessa lista. Se não estiver adicionado, adicione-o agora:

     • Clique em Set Network Access for Host

     • Clique em + Add IP Address

     • Retorne ao assistente de migração em produção. Selecione o cluster de origem no menu suspenso e escolha Migrate data to this cluster em .

   • Selecione o cluster de origem no menu suspenso.

   • Se o cluster de origem impor a autenticação, insira um nome de usuário e senha nas caixas de texto fornecidas.

     Consulte Segurança do cluster de origem para obter orientação sobre as permissões de usuário exigidas pela migração em produção do Atlas.

   • If you suspend the source cluster from automation in Cloud Manager, but continue to monitor the source cluster with the Monitoring Agent, the Username and Password display. If your deployment requires user authentication, provide the user name and password in these fields. The database user whose credentials you provide must have at least the backup role on the admin database and must be authenticated using both SCRAM-SHA-1 and SCRAM-SHA-256.

   • Se o cluster de origem usar TLS, alterne o botão Is encryption in transit enabled?.

   • Se o cluster de origem usar TLS com uma Autoridade de Certificação Raiz personalizada (CA), copie o caminho para o arquivo CA do seu host de migração e cole este caminho na caixa de texto fornecida. O arquivo deve estar presente no host de migração para garantir que o host de migração possa ler o certificado. O Atlas verifica se o certificado está presente e legível.

   • Se o cluster de destino tiver dados que você deseja preservar, mantenha a opção Clear any existing data on your destination cluster desmarcada. O serviço de migração em tempo real verifica uma amostra de documentos durante a validação e avisa se encontrar namespaces duplicados. Se você deseja excluir os dados existentes, marque esta opção e, em seguida, insira o nome do cluster de destino.

   • Escolha uma conexão para se conectar ao cluster. O Standard connection sempre aparece como disponível na interface do usuário. No entanto, outras opções de conexão serão habilitadas somente se você tiver configurado anteriormente uma conexão de Peering VPC ou um endpoint privado para seus clusters. Se o Atlas detectar que você não tem conexões VPC ou endpoints privados configurados, essas opções ficarão esmaecidas.

     • Se você não estiver usando o VPC Peering ou um endpoint privado, clique em Standard connection e prossiga para o estágio Validation desta etapa.

     • If you configured a VPC peering connection between the migration host and the Atlas replica set, the VPC Peering option is active. Click VPC Peering to connect using VPC peering for live migration. If the VPC Peering option is grayed out, configure a VPC peering connection before starting this procedure. To learn more, see Support for VPC Peering and Private Endpoints.

     • If you configured a private endpoint between the migration host and the Atlas cluster, the Private Endpoint option is active. Click Private Endpoint to connect with a private endpoint, and then select a previously-configured private endpoint from the dropdown. Only private endpoints that are in AVAILABLE state are valid. If the Private Endpoint option is grayed out, configure a private endpoint before starting this procedure. To learn more, see Support for VPC Peering and Private Endpoints.

       Observação

       Para migrações push live, endpoints privados são suportados apenas para clusters distribuídos em um único provedor de nuvem e uma única região.

   • Clique Validate. O processo de validação verifica se o seu host de migração está acessível e realiza as seguintes verificações de validação para garantir que você possa iniciar a migração em produção para o Atlas.

     Para aproveitar as seguintes verificações de validação, atualize o MongoDB Agent no Cloud Manager para a versão mais recente. As seguintes verificações de validação são executadas durante a migração em produção:

     • O host de migração pode se conectar ao cluster de destino.

     • Se o cluster de origem usar TLS com uma Autoridade de Certificação Raiz personalizada (CA), o host de migração poderá acessar o cluster de origem usando TLS.

     • As credenciais do trigger de reconhecimento de data center são válidas. Essa verificação de validação será executada somente se você interromper a automação do cluster de origem no Cloud Manager, mas continuar monitorando o cluster de origem com o agente de monitoramento.

     • The migration process validates that the destination cluster has enough disk space based on the storage size of the compressed data. To learn more about data and storage sizes, see dbStats.

   • Se a validação falhar, verifique o host de migração, a validade dos seus endereços IP externos ou bloco CIDR e o link-token. Verifique também as credenciais de usuário de banco de dados, seus certificados TLS e a quantidade de tamanho de armazenamento em disco no cluster de destino.

   • Se a validação for bem-sucedida, clique em Next.

Inicie a migração.

1. Revise o relatório que lista a organização de origem, o projeto e o cluster, bem como o host de migração que o processo de migração em produção usará.

2. Clique em Start the Migration.

   Depois que o processo de migração começa, a IU do Atlas exibe a Migrating Data tela passo a passo para o cluster do Atlas de destino. A tela de apresentação é atualizada à medida que o cluster de destino prossegue com o processo de migração. O processo de migração inclui:

   • Aplicação de novas gravações nos dados do cluster de origem nos dados do cluster de destino.

   • A cópia de dados do cluster de origem para o cluster de destino.

   • Finalizando a migração no cluster de destino.

   Um valor de tempo de atraso é exibido durante a fase final do processo de migração que representa o atraso atual entre os clusters de origem e de destino.

   Quando o temporizador de atraso está próximo de zero e o processo de migração é recuperado, o Atlas ativa o botão Cutover to your destination cluster e indica que os clusters de origem e destino estão sincronizados. Prossiga para a próxima etapa.

Execute a transição.

A substituição é um processo de três etapas de direcionamento das leituras e gravações do aplicativo do cluster de origem para o cluster de destino.

Quando o Atlas detecta que os clusters de origem e destino estão quase sincronizados, ele inicia um temporizador extensível de 120 horas (5 dias) para iniciar o estágio de substituição do procedimento de migração live. Após a passagem do período 120 horas, o Atlas para de sincronizar com o cluster de origem.

Nesse estágio do processo de migração, você pode prosseguir para a substituição ou estender o período de sincronização e, em seguida, prosseguir para a substituição.

• Se você clicar em I'm ready to cutover, o Atlas iniciará o processo de cutover.

• Se você clicar em Extend Sync e se a sincronização estendida for concluída com êxito, o Atlas confirmará que os clusters de origem e destino estão sincronizados. Prossiga com o processo de transição. Se o tempo de sincronização expirar, você poderá tentar novamente a migração.

  Se a migração estiver para expirar, o Atlas enviará um e-mail semelhante ao exemplo a seguir:

  A migration to your Atlas cluster will expire in <number> hours!
  Navigate to your destination cluster to start the cutover process. If
  you don't take any action within <number> hours, the migration will be
  cancelled and you will need to start again. You can also extend the
  migration process if you need more time.

1. Clique I'm ready to cutover. Prossiga com o processo de transição de três etapas rapidamente para garantir o mínimo de tempo de inatividade para seu aplicação.

2. Clique Proceed to cutover. O processo de transição de três etapas começa:

   1. Interrompa as gravações em seu cluster de origem. Clique I confirm that I've stopped writes to my source cluster. Clique em Finalize migration para prosseguir.

   2. Aguarde alguns minutos enquanto o Atlas finaliza a migração. O Atlas executa estas ações para concluir o processo:

      • Remove as sub-redes do servidor de migração ao vivo do MongoDB da lista de acesso IP no cluster de destino.

      • Remover o usuário de banco de dados que a migração em produção usou para importar dados para o cluster de destino.

      Se o processo de transferência estiver em andamento há pelo menos 12 horas, a Atlas envia um e-mail sugerindo que você verifique o processo de migração ou entre em contato com o suporte.

   3. Se a migração for bem-sucedida, a página You have successfully migrated to Atlas será exibida. O Atlas mostra o status das alterações sincronizadas, o tempo de inatividade do aplicação , a duração do processo de migração, a quantidade de dados iniciais copiados e o número de coleções copiadas.

      • Verifique se seus dados são transferidos para o cluster de destino comparando contagens de documento e executando comparações de hash. Para saber mais, consulte Mongosync: Verificar Transferência de Dados.

      • Clique Connect to your new cluster. O Atlas redirecionará você para a página Connect to Atlas , onde você pode escolher um método de conexão.

      • Depois de se conectar ao cluster, retome as gravações no cluster de destino.