Migre (push) um MongoDB 6.0.17+ ou 7.0.13+ Cluster monitorado pelo Cloud Manager no Atlas

No Atlas, acesse a página Organization Settings.

1. Se ainda não estiver exibido, selecione sua organização desejada no Menu Organizations na barra de navegação.

2. Clique no ícone Organization Settings próximo ao menu Organizations.

   A página Configurações da organização é exibida.

Acesse a página Live Migration to Atlas.

Clique em Live Migration na barra lateral.

A página migração em produção para Atlas é exibida.

Inicie o processo de migração.

1. Clique em Migrate from Ops Manager or Cloud Manager.

   Observação

   O rótulo da UI menciona o Ops Manager, no entanto, para esse procedimento, você só pode migrar para os sistemas Atlas MongoDB 6.0.17 ou posterior 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 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 projeto 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.

Se você ainda não o fez, crie um cluster de destino no Atlas. Consulte Acesso necessário.

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 Ops Manager or Cloud Manager.

   Observação

   O rótulo da UI menciona o Ops Manager, no entanto, para esse procedimento, você só pode migrar para os sistemas Atlas MongoDB 6.0.17 ou posterior 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 fragmentar as collections, clique na marca de seleção em Include sharding parameters e cole seu JSON de configuração de fragmentação na caixa de texto usando o exemplo de fragmentação. Salve esta configuração em um arquivo externamente, caso você queira consultá-la mais tarde.

       A configuração de fragmentação JSON define a matriz shardingEntries, que especifica as coleções a serem fragmentadas e as chaves a serem usadas na fragmentação. O MongoDB fragmenta apenas as coleções que você inclui nessa array. Para saber mais, consulte Fragmentação.

       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 ponto de extremidade privado, 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.

   • Se você suspender o cluster de origem da automação no Cloud Manager, mas continuar monitorando o cluster de origem com o agente de monitoramento, o Username e o Password serão exibidos. Se sua implantação exigir autenticação de usuário, forneça o nome de usuário e a senha nesses campos. O usuário do banco de dados cujas credenciais você fornece deve ter pelo menos a função de backup no banco de dados admin e deve ser autenticado usando SCRAM-SHA-1 e SCRAM-SHA-256.

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

   • Se o cluster de origem usar TLS/SSL com uma Autoridade de Certificação Raiz personalizada (CA), copie o caminho para o arquivo CA do seu host de migração e cole esse 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.

     • Se você configurou uma conexão de emparelhamento de VPC entre o host de migração e o conjunto de réplica do Atlas , a opção VPC Peering estará ativa. Clique VPC Peering para se conectar usando o emparelhamento VPC para migração live. Se a opção VPC Peering estiver esmaecida, configure uma conexão de emparelhamento VPC antes de iniciar este procedimento. Para saber mais, consulte Suporte para emparelhamento de VPC e endpoints privados.

     • Se você configurou um terminal privado entre o host de migração e o cluster Atlas, a opção Private Endpoint estará ativa. Clique em Private Endpoint para conectar-se a um endpoint privado e selecione um endpoint privado configurado anteriormente no menu suspenso. Somente endpoints privados que estão no estado AVAILABLE são válidos. Se a opção Private Endpoint estiver esmaecida, configure um terminal privado antes de iniciar o procedimento. Para saber mais, consulte Suporte para peering de VPC e endpoints privados.

       Observação

       Para migração em produção em que os clusters de origem e destino estão executando o MongoDB 6.0.17 ou posterior, os endpoints privados são suportados somente para clusters implantados em um único provedor de nuvem e em 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/SSL com uma Autoridade de Certificação Raiz personalizada, o host de migração poderá acessar o cluster de origem usando TLS/SSL.

     • 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.

     • O processo de migração valida se o cluster de destino tem espaço em disco suficiente com base no tamanho de armazenamento dos dados compactados. Para saber mais sobre dados e tamanhos de armazenamento, consulte 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 do trigger de banco de dados, seus certificados TLS/SSL e a quantidade de tamanho de armazenamento em disco no reconhecimento de data center 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 Cluster-to-Cluster Sync: 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.