Migre ao vivo (push) um MongoDB 6.0.13+ ou 7.0.8+ Cluster monitorado pelo Cloud Manager no Atlas

Nesta página

Restrições

Caminho de migração e plataformas compatíveis
Pares de configuração de cluster de origem e destino suportados
Acesso necessário
Pré-requisitos
Considerações
Migre seu cluster
API de migração em produção por push
Comandos de migração em produção por push da CLI
Suporte à migração

Se ambos os clusters de origem e destino estiverem executando MongoDB 6.0.13+ ou 7.0.8+, e o Cloud Manager monitorar o cluster de origem, o Atlas pode enviar um cluster de origem para um cluster do Atlas usando o procedimento descrito nesta seção.

Esse processo usa o mongosync como ferramenta subjacente de migração de dados, permitindo migrações ao vivo mais rápidas com menos tempo de inatividade:

O Atlas sincroniza dados da origem para o cluster de destino até que você transfira seus aplicativos para o conjunto de réplicas do Atlas de destino.
Depois de atingir a etapa de substituição no procedimento a seguir:
- Pare as gravações no cluster de origem.
- Pare suas instâncias de aplicativo, aponte para o Atlas cluster e reinicie-as.

Restrições

As Limitações de Sincronização de Cluster para Cluster se aplicam a essa migração live.

Suporte para emparelhamento de VPC e endpoints privados

A tabela a seguir lista o status atual do suporte para Peering de VPC e endpoints privados para clusters de origem e destino que você migra em tempo real para o Atlas. Selecione a guia para conjuntos de réplicas ou clusters fragmentados.

Caminho de migração e plataformas compatíveis

A migração live do Cloud Manager para o Atlas é compatível com todas as plataformas nas quais você pode provisionar um host para o mongosync. Para obter uma lista completa das plataformas compatíveis nas quais você pode provisionar um host para o mongosync, consulte plataformas mongosync.

A migração em produção (push) do Atlas é compatível com os seguintes caminhos de migração:

cluster de origem Versão do MongoDB	cluster do Atlas Versão do MongoDB
6 . 0 . 13	6 . 0 . 13
7 . 0 . 8	7 . 0 . 8

Pares de configuração de cluster de origem e destino suportados

Para esse tipo de migração em produção, o Atlas suporta os seguintes pares de configuração de cluster de origem e destino:

Configuração do cluster de origem	Configuração do cluster de destino	Notas
Autônomo	Qualquer tipo de cluster	Antes de migrar um cluster de origem standalone usando esse procedimento de migração, converta o standalone em um conjunto de réplicas.
Conjunto de réplicas	Conjunto de réplicas
Conjunto de réplicas	Cluster fragmentado	Ao executar este tipo de migração, você pode especificar parâmetros de fragmentação. Para saber mais, consulte o procedimento de migração ao vivo nesta seção e este exemplo de fragmentação.
Cluster fragmentado	Cluster fragmentado	O número de shards nos clusters de origem e destino pode ser diferente. O cluster fragmentado de origem deve usar CSRS (Config Server Replica Sets). Para saber mais, consulte Servidores de configuração do conjunto de réplicas.
Cluster fragmentado	Conjunto de réplicas

Acesso necessário

Para migrar seus dados ao vivo, você deve ter acesso de Project Owner ao Atlas.

Os usuários com acesso Organization Owner devem se adicionar ao projeto como um Project Owner.

Pré-requisitos

Antes de iniciar a migração push live de um cluster executando o MongoDB 6.0.13 ou posterior, ou 7.0.8 ou posterior monitorado no Cloud Manager to Atlas:

Atualize o cluster de origem para MongoDB 6.0.13 ou posterior.
Crie uma conta Atlas.
Crie uma organização Atlas e, em seguida, crie um projeto nessa organização.
Implemente seu cluster neste projeto.
Conecte-se ao seu cluster a partir de todos os servidores clientes onde seus aplicativos são executados.
Considere configurar uma conexão de Peering VPC ou um endpoint privado entre cada host de migração e o cluster do Atlas de destino, no mesmo fornecedor de cloud e na mesma região do cluster de destino.
Observação
Se você optar por não utilizar o emparelhamento VPC ou endpoints privados ao migrar conjuntos de réplicas, o processo de migração live será executado em endereços IP públicos que você adicionar à lista de acesso IP do projeto Atlas como parte do procedimento de migração live nesta seção.
Em seu cluster de origem no Cloud Manager, provisione um host de migração no Cloud Manager.
- O nome de usuário e a senha usados para se conectar ao cluster de origem.
- Se você não estiver usando um endpoint privado entre o host de migração e o cluster do Atlas, obtenha os endereços IP externos ou blocosCIDR do dos hosts de migração provisionados no Cloud Manager do administrador do Cloud Manager.
- Se o cluster de origem usar TLS/SSL com uma Autoridade de Certificação Raiz Personalizada, para garantir que os hosts possam ler o certificado, adicione o arquivo CA do cluster de origem aos host de migração.
Durante o processo de migração ao vivo, o Atlas valida que pode coletar estatísticas do banco de dados MongoDB usando dbStats. Antes de realizar a migração live para um Atlas cluster, revise as configurações do projeto do cluster de origem no Cloud Manager e garanta que a opção Collect Database Specific Statistics esteja habilitada. Essa opção é habilitada por padrão no Cloud Manager e deve permanecer habilitada para que o processo de migração passe pela validação.

Se o cluster for executado com autenticação, atenda aos seguintes pré-requisitos:
- Para conjuntos de réplicas, conceda as funções backup e readAnyDatabase no banco de dados de administração ao usuário que executará o processo de migração.
- Para clusters fragmentados, conceda as funções backup, readAnyDatabase e clusterMonitor no banco de dados de administração ao usuário que executará o processo de migração. Certifique-se de que o usuário especificado exista em cada shard e no conjunto de réplicas do servidor de configuração. O usuário deve ter permissões que permitam as seguintes ações:
  - Pare ou inicie o balanceador de cluster fragmentado.
  - Leia todos os bancos de dados e coleções no host.
  - Leia o oplog no host.
- Certifique-se de que este usuário esteja autenticado usando SCRAM-SHA-1 e SCRAM-SHA-256. Para saber mais, consulte Segurança do Cluster de Origem.
Importante
Fonte Prontidão do cluster
Para ajudar a garantir uma migração de dados tranquila, seu cluster de origem deve atender a todas as recomendações de cluster de produção. Verifique a Lista de verificação de operações e as Notas de produção antes de iniciar o processo de migração ao vivo.

Fluxo de trabalho de migração em produção

Esta seção descreve o fluxo de trabalho. Para obter etapas detalhadas, consulte o procedimento para migrar um cluster do Cloud Manager para o Atlas.

"Para migrar em produção sua implantação para o Atlas, gere um link-token, provisione um host de migração e inicie a migração em produção."

As etapas do fluxo de trabalho de migração em produção são:

Estágio 1: Vincular com o Atlas. Execute esta etapa no Atlas, após ter criado sua conta, organização e projeto do Atlas; implementou seu cluster dedicado neste projeto; e pode se conectar a ele.
1. Na organização Atlas, Go para Live Migration.
2. Selecione Migrate from Cloud Manager e inicie o assistente de migração em produção.
Estágio 2: Provisionar o host de migração.
- provisionar um host de migração no Cloud Manager. Um host de migração executa um MongoDB Agent dedicado que orquestra o processo de migração live do Cloud Manager para o Atlas.
  Observação
  Se você estiver migrando uma implementação de origem do MongoDB que não usou o Cloud Manager antes, adicione os processos MongoDB existentes ao Cloud Manager.
- Na Live Migration: Connect to Atlas seção da Settings página da sua organização do Cloud Manager, selecione Connect to Atlas e cole o link-token que você criou no Atlas. Para saber mais, consulte Conectar ao Atlas para migração live no Cloud Manager.
Estágio 3: iniciar a migração. No Atlas, siga as etapas do assistente para iniciar o processo de migração em produção.

Endereço IP externo do host de migração no Cloud Manager

Antes de iniciar o procedimento de migração em produção, adicione os endereços IP ou blocos CIDR dos hosts de migração à lista de acesso IP do projeto. O Atlas permite conexões com o cluster de destino somente de hosts com entradas na lista de acesso do projeto.

Validação de pré-migração

Antes de iniciar o procedimento de migração ao vivo, o Atlas executa verificações de validação nos clusters de origem e destino.

A versão do MongoDB do cluster de origem e destino é de pelo menos FCV 6.0 e está correspondendo conforme descrito em Restrições.
O usuário do banco de dados do cluster de origem tem as permissões corretas, conforme descrito em Segurança do Cluster de Origem.
O cluster de origem permite coletar estatísticas do banco de dados para seu projeto no Cloud Manager. Isso permite ao Atlas coletar estatísticas do banco de dados MongoDB durante o processo de migração ao vivo. Para confirmar que a opção Collect Database Specific Statistics está habilitada, revise as configurações do projeto do cluster de origem no Cloud Manager.
O cluster do Atlas de destino não tem o BI Connector para Atlas habilitado.

Segurança do cluster de origem

Vários papéis embutidos fornecem privilégios suficientes. Por exemplo:

Para clusters de conjuntos de réplicas de origem, um usuário MongoDB deve ter as funções readAnyDatabase e backup .

Para clusters fragmentados de origem, um usuário do MongoDB deve ter as funções readAnyDatabase, backup e clusterMonitor .

Para verificar se o usuário do banco de dados que executará o processo de migração ao vivo tem essas funções, execute o comando db.getUser() no banco de dados admin . Por exemplo, para um conjunto de réplicas, execute:

use admin
db.getUser("admin")
{
    "_id" : "admin.admin",
    "user" : "admin",
    "db" : "admin",
    "roles" : [
  {
    "role" : "backup",
    "db" : "admin"
  },
  {
    "role" : "readAnyDatabase",
    "db" : "admin"
  }
 ]
} ...

Especifique o nome de usuário e senha para Atlas quando solicitado pela tela passo a passo do procedimento de migração ao vivo.

O Atlas só é compatível com a SCRAM para conexão com clusters de origem que impõem autenticação.

Requisitos de segurança para o host de migração

Para migração em produção do tipo push, você é responsável por provisionar, proteger e executar o host de migração. O host de migração criptografa somente a comunicação de saída com cluster do Atlas.

Para saber mais sobre a segurança do Atlas, consulte o whitepaper Atlas Security .

Considerações

Criptografia de rede

Durante a migração em produção, se o cluster de origem não usar a criptografia TLS para seus dados, o tráfego do cluster de origem para o host de migração não será criptografado, mas o tráfego do host de migração para o Atlas será criptografado. Determine se isso é aceitável antes de iniciar um procedimento de migração em produção.

Usuários e funções do banco de dados

Se o cluster de origem não usar autenticação, você deverá criar um usuário no Atlas porque o Atlas não oferece suporte à execução sem autenticação.

O Atlas não migra nenhum dado de usuário ou papel para o cluster de destino.

Se o cluster de origem aplicou autenticação, antes de migrar você deverá recriar o mecanismo de autenticação apropriado utilizado por seus aplicativos no cluster do Atlas de destino. A tabela seguinte lista os mecanismos de autenticação e como configurá-los no Atlas.

Mecanismo de autenticação	Método de configuração
SCRAM	Crie trigger de banco de dados com SCRAM para autenticação de senha.
LDAP	Configure o LDAP.
Amazon Web Services KMS, Azure Key Vault, GCP KMS	Configure a criptografia KMS.

balanceador de cluster de origem

A migração live do Atlas interrompe o balanceador de cluster fragmentado no cluster de origem no início do procedimento e inicia o balanceador no final do procedimento.

Se você cancelar a migração em produção, o Atlas reiniciará o balanceador no cluester de origem.

Observação

Em algumas circunstâncias, o Atlas não pode reiniciar o balancer no cluster de origem no final de um processo de migração live. Se o balanceador não reiniciar, a migração live ainda será bem-sucedida, mas um banner de aviso indicará que você deve reiniciar manualmente o balanceador do cluster de origem.

Configuração do cluster de destino

Para o cluster de destino, as seguintes considerações se aplicam:

Os clusters de origem e destino são ambos conjuntos de réplicas ou ambos são clusters fragmentados. O número de fragmentos pode ser diferente entre o cluster de origem e o cluster de destino.
Você não pode selecionar um cluster de camada M0 (camada grátis) ou M2/M5 de camada compartilhada como o destino para a migração em produção.

O cluster de destino no Atlas deve corresponder ou exceder a implantação de origem em termos de RAM, CPU e armazenamento. Provisione um cluster de destino de tamanho adequado para que ele possa acomodar o processo de migração e a carga de trabalho esperada, ou escale o cluster de destino para um nível com mais capacidade de processamento, largura de banda ou E/S de disco.
Para maximizar o desempenho da migração, use pelo menos um cluster M40 para o cluster de destino. Ao migrar grandes conjuntos de dados, use um cluster M80 com 6000 discos IOPS ou superior.
Você também pode optar por aumentar temporariamente o tamanho do cluster do Atlas de destino durante o processo de migração. Depois de migrar a carga de trabalho do aplicativo para um cluster no Atlas, entre em contato com o suporte para obter assistência com o ajuste de desempenho adicional e o dimensionamento do cluster de destino para minimizar os custos.
Para evitar alterações inesperadas no dimensionamento, desative o dimensionamento automático no cluster de destino. Para mais informações, consulte Gerenciar Clusters.
Para evitar o crescimento ilimitado da coleta de oplog, configure um tamanho de oplog fixo pela duração do processo de migração ao vivo. Para saber mais, consulte Acesso Exigido e Opções de Configuração do Atlas. Se você estiver observando problemas de desempenho mesmo depois de seguir essas recomendações, entre em contato com o suporte.

Não altere o sinalizador featureCompatibilityVersion enquanto a migração em produção do Atlas estiver em execução.

Evite Volumes de trabalho no Cluster de Destino

Evite executar quaisquer cargas de trabalho, inclusive aquelas que possam estar sendo executadas em namespaces que não se sobreponham ao processo de migração em tempo real, no cluster de destino. Essa ação evita possíveis conflitos de bloqueio e degradação de desempenho durante o processo de migração ao vivo.

Não execute várias migrações para o mesmo cluster de destino ao mesmo tempo.

Não inicie o processo de corte de seus aplicativos para o cluster de destino enquanto o processo de migração ao vivo estiver sincronizando.

Evite backups em nuvem

O Atlas para de tirar snapshots de backup em nuvem sob demanda do cluster de destino durante a migração ao vivo. Depois que você concluir a etapa de cutover no procedimento de migração em tempo real nesta página, o Atlas retomará a captura de snapshots de backup na nuvem com base em sua política de backup.

Evitar alterações no namespace

Não faça nenhuma alteração de namespace durante o processo de migração, como utilizar o comando renameCollection ou executar um pipeline de agregação que inclua o estágio de agregação do $out .

Evitar eleições

O processo de migração ao vivo faz a melhor tentativa de continuar uma migração durante interrupções temporárias de rede e eleições nos clusters de origem ou destino. No entanto, esses eventos podem causar falha no processo de migração ao vivo. Se o processo de migração em tempo real não puder ser recuperado automaticamente, reinicie-o desde o início.

Ambientes de preparação e produção

Considere executar o seguinte procedimento duas vezes. Execute uma migração parcial que pare primeiro na etapa Perform the Cutover . Isso cria um cluster de preparo atualizado apoiado pelo Atlas para testar o comportamento e o desempenho do aplicativo usando a versão mais recente do driver que oferece suporte à versão do MongoDB do cluster Atlas.

Depois de testar sua aplicação, execute o procedimento completo de migração usando um Atlas cluster separado para criar seu ambiente de produção com suporte do Atlas.

Migre seu cluster

Importante

Evite fazer alterações na configuração do cluster de origem durante a execução do procedimento de migração live, como remover membros do conjunto de réplicas ou modificar configurações de tempo de execução do mongod , como featureCompatibilityVersion.

Procedimento

Inicie o processo de migração.

No painel esquerdo da página da sua organização, clique em Live Migration.
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.13 ou posterior que o Cloud Manager monitora.
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.

Clique Generate Link-Token. O Atlas exibe a página para gerar um link-token.
Clique em Next para ver uma página que contém o link-token gerado.
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.
Clique em Done.

Cole o link-token no Cloud Manager.

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.
Clique em Settings no painel de navegação esquerdo.
Na seção Live Migration: Connect to Atlas , clique em Connect to Atlas. A caixa de diálogo Connect to Atlas aparece.
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.

Caso ainda não tenha feito isso, crie um cluster de destino no Atlas. Consulte Acesso necessário.

Inicie a migração do cluster de destino.

Clique em Select Target Cluster from Projects.
Vá para o projeto do seu Atlas cluster de destino e encontre seu cluster de destino.
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.
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.13 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 array shardingEntries , que especifica as collections 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 depois de migrar seu cluster para o Atlas.
  - Além da configuração de fragmentação, deve existir um índice compatível para as chaves de fragmentação especificadas no cluster de destino em serviço.
    Clique na marca de seleção em Create supporting indexes para que o MongoDB crie automaticamente índices de chave de shard 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 a automação do cluster de origem no Cloud Manager, mas continuar monitorando o cluster de origem com o Agente de Monitoramento, o Username e Password serão exibidos. Se o seu sistema exigir autenticação do usuário, forneça o nome de usuário e senha nestes 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 e você quiser preservá-los, mantenha a opção Clear any existing data on your destination cluster desmarcada. O serviço de migração em produção avisa se encontrar namespace duplicados. Se você deseja excluir os dados existentes, marque esta opção.
- 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 endpoint privado entre o host de migração e o cluster do Atlas, a opção Private Endpoint estará ativa. Clique Private Endpoint para se conectar a um endpoint privado e selecione um endpoint privado configurado anteriormente no menu suspenso. Somente endpoints privados que estão em AVAILABLE estado são válidos. Se a opção Private Endpoint estiver acinzentada, configure um endpoint privado antes de iniciar este procedimento. Para saber mais, consulte Suporte para emparelhamento de VPC e endpoints privados.
    Observação
    Para migrações push live em que os clusters de origem e destino estão executando o MongoDB 6.0.13 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 live:
  - 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.

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á.
Clique em Start the Migration.

Prepare-se para o cut over.

Quando o temporizador de atraso e o botão Prepare to Cutover se tornarem verdes, clique nele para prosseguir para a próxima etapa.

Execute a transição.

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 o período de 120 horas passar, o Atlas parará de sincronizar com o cluster de origem. You can extend the time remaining by 24 hours by clicking Extend time below the <time> left to cut over timer.

Clique Prepare to Cutover. O Atlas exibe uma tela de apresentação que declara: Your migration is almost complete! A tela de apresentação exibe as seguintes instruções sobre como proceder com o processo de cutover:
1. Pare seu aplicativo. Isso garante que não ocorra mais nenhuma gravação no cluster de origem.
2. Aguarde até que a lacuna do tempo de operação chegue a zero. Quando o contador chega a zero, os clusters de origem e destino estarão sincronizados.
3. Marque a caixa que diz: I confirm that I am ready to cut over the application to the destination cluser. By proceeding, Atlas will finalize the migration. This process will take a few seconds. Once it is complete you can point your application at the destination cluster and begin writing to it.
Clique Cutover. O Atlas conclui a migração e exibe a página Connect .
Decida quando retomar as gravações no cluster de destino. Você pode fazer o seguinte:
- Aguarde até que o banner na placa do cluster especifique: Your cluster migration is complete e, em seguida, retome as gravações no cluster de destino. Se você optar por aguardar a conclusão da migração, seu aplicativo sofrerá uma pausa temporária nas gravações durante o período necessário para finalizar a migração.
  ou
- Inicie as gravações do aplicativo no cluster de destino sem aguardar a conclusão da migração, enquanto o banner do cartão do cluster exibe: Your destination cluster in Atlas is ready to accept writes, but we are still finalizing the migration. Se você optar por mover as gravações para o cluster de destino sem aguardar até o final do processo de migração e a migração live falhar em os estágios finais e emitir um erro, você deverá redirecionar as gravações de volta para seu cluster de origem e reiniciar o processo de migração ao vivo.
Quando estiver pronto para redirecionar gravações para o cluster de destino no Atlas:
1. Use a connection string do cluster de destino para se conectar ao seu aplicativo.
2. Confirme que seu aplicativo está funcionando com o cluster de destino do Atlas.

O Atlas executa estas ações para concluir o processo:

Remove as sub-redes do servidor de migração ao vivo MongoDB da lista de acesso IP no cluster de destino.
Remove o usuário do banco de dados que a migração live usou para importar dados para o cluster de destino.
Marca o processo de migração como concluído.

API de migração em produção por push

Para executar tarefas associadas ao procedimento de migração live, consulte API de Migração live por push.

Observação

As API de migração em produção mencionam o Cloud Manager ou o Ops Manager, no entanto, o tipo de migração em produção descrito nesta seção oferece suporte apenas à migração de cluster de origem monitorados no Cloud Manager para clusters de destino no Atlas.

Comandos de migração em produção por push da CLI

Para migrar um cluster utilizando o Atlas CLI, você pode executar as seguintes etapas:

Criar ou excluir um link-token
Criar ou visualizar uma tarefa de validação
Criar ou exibir uma tarefa de migração
Executar a transição

Para outras etapas no procedimento de migração live , você deve usar a UI do Cloud Manager ou a UI do Atlas. Para saber mais, consulte o fluxo de trabalho de migração em produção.

Antes de migrar um cluster utilizando o Atlas CLI, conclua a validação pré-migração.

Observação

Antes de executar comandos Atlas CLI, você deve:

Criar ou excluir um link-token

Para criar um novo link-token utilizando o Atlas CLI, execute o seguinte comando:

atlas liveMigrations link create [options]

Para excluir o link-token especificado usando o Atlas CLI, execute o seguinte comando:

atlas liveMigrations link delete [options]

Para saber mais sobre a sintaxe e parâmetros para os comandos anteriores, consulte a documentação do Atlas CLI para a criação de link do atlas liveMigrations e a exclusão de link do atlas liveMigrations.

Se você estiver migrando do Ops Manager, solicite um endereço IP externo e especifique-o no link-token. Para saber mais, consulte Solicitar um endereço IP externo na documentação do Ops Manager.

Criar e visualizar uma tarefa de validação

Para criar uma nova solicitação de validação utilizando o Atlas CLI, execute o seguinte comando:

atlas liveMigrations validation create [options]

Para retornar os detalhes da solicitação de validação que você especifica utilizando o Atlas CLI, execute o seguinte comando:

atlas liveMigrations validation describe [options]

Para saber mais sobre a sintaxe e parâmetros para os comandos anteriores, consulte a documentação do Atlas CLI para a Criação de validação do atlas liveMigrations e Descrição de validação do atlas liveMigrations.

Para saber o que o Atlas valida, consulte o marcador Validate na seção Migrate Your Cluster nesta página.

Criar e visualizar uma tarefa de migração

Para criar uma nova tarefa de migração usando o Atlas CLI, execute o seguinte comando:

atlas liveMigrations create [options]

Para retornar os detalhes da tarefa de migração que você especifica utilizando o Atlas CLI, execute o seguinte comando:

atlas liveMigrations describe [options]

Para saber mais sobre a sintaxe e parâmetros para os comandos anteriores, consulte a documentação do Atlas CLI para a criação do Atlas liveMigrations e descrição do Atlas liveMigrations.

Executar a transição

Para iniciar a substituição para migração em produção usando o Atlas CLI, execute o seguinte comando:

atlas liveMigrations cutover [options]

Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para o cutover do Atlas liveMigrations.

Quando a transferência for concluída, o Atlas concluirá o processo de migração em produção e interromperá a sincronização com o cluster de origem. Para saber mais, consulte a seção Migrate Your Cluster nesta página.

Observação

Os comandos da CLI de migração em produção podem mencionar o Cloud Manager ou o Ops Manager, no entanto, o tipo de migração em produção descrito nesta seção oferece suporte apenas à migração de cluster de origem monitorados no Cloud Manager para clusters de destino no Atlas.

Suporte à migração

Se você tiver alguma dúvida sobre o suporte à migração além do que é abordado nesta documentação, ou se encontrar um erro durante a migração, solicite suporte por meio da interface do usuário do Atlas.

Como arquivar um ticket de suporte:

Clique em Support na navegação à esquerda.
Clique em Request Support.
Para Issue Category, selecione Help with live migration.
Para Priority, selecione a prioridade apropriada. Para perguntas, selecione Medium Priority. Se houve uma falha na migração, selecione High Priority.
Para Request Summary, inclua Live Migration no seu resumo.
Para More details, inclua quaisquer outros detalhes relevantes à sua pergunta ou erro de migração.
Clique no botão Request Support para enviar o formulário.

← Migre (pull) ao vivo um MongoDB 6.0.13+ ou 7.0.8+ Cluster no Atlas

Exemplo: migração ao vivo de conjuntos de réplicas para clusters fragmentados →

Restrições

Suporte para emparelhamento de VPC e endpoints privados

Caminho de migração e plataformas compatíveis

Pares de configuração de cluster de origem e destino suportados

Acesso necessário

Pré-requisitos

Observação

Importante

Fonte Prontidão do cluster

Fluxo de trabalho de migração em produção

Observação

Endereço IP externo do host de migração no Cloud Manager

Validação de pré-migração

Segurança do cluster de origem

Requisitos de segurança para o host de migração

Considerações

Criptografia de rede

Usuários e funções do banco de dados

balanceador de cluster de origem

Observação

Configuração do cluster de destino

Evite Volumes de trabalho no Cluster de Destino

Evite backups em nuvem

Evitar alterações no namespace

Evitar eleições

Ambientes de preparação e produção

Migre seu cluster

Importante

Procedimento

Inicie o processo de migração.

Observação

Vincular com o Atlas.

Observação

Cole o link-token no Cloud Manager.

Criar o cluster do Atlas de destino.

Inicie a migração do cluster de destino.

Observação

Observação

Inicie a migração.

Prepare-se para o cut over.

Execute a transição.

API de migração em produção por push

Observação

Comandos de migração em produção por push da CLI

Observação

Criar ou excluir um link-token

Criar e visualizar uma tarefa de validação

Criar e visualizar uma tarefa de migração

Executar a transição

Observação

Suporte à migração