Você pode migrar dados das suas implantações do MongoDB no local para o Atlas usando um dos vários métodos. Recomendamos o uso da migração em produção do Atlas sempre que possível, pois ela automatiza muitas das tarefas com o menor tempo de inatividade, mas você pode usar outras ferramentas que acomodam a variedade e a complexidade inerentes à migração de banco de dados.
Visão geral da migração em produção
A migração em produção do Atlas automatiza a movimentação de dados de bancos de dados MongoDB no local para o Atlas. A migração em produção do Atlas inclui os seguintes recursos:
O host de migração sempre criptografa o tráfego para o cluster do Atlas. O tráfego de, para e entre os nós do Atlas é sempre criptografado, e esse recurso não pode ser desativado. Somente usuários com funções específicas de banco de dados de Controle de Acesso Baseado em Função (RBAC) (como
backup,readAnyDatabaseouclusterMonitor) e o proprietário do projeto do Atlas podem iniciar uma migração em produção. Os usuários se autenticam em clusters usando SCRAM-SHA-1 ou SCRAM-SHA-256.A migração em produção automatiza a maioria das tarefas. Para o método "pull" totalmente gerenciado, a migração em produção monitora as principais métricas, provisiona os servidores de migração e executa o sequenciamento estrito dos comandos de migração. Além disso, você também pode selecionar as configurações de camada do cluster do Atlas de destino para as quais você gostaria de migrar.
Instruções detalhadas o ajudam a dimensionar clusters de destino para controlar custos. As recomendações incluem o dimensionamento adequado do cluster e realização de um escalonamento temporário, seguido de um redimensionamento para níveis ideais pós-migração.
A migração ao vivo usa o Mongosync nos backstend, o que facilita a transição rápida por meio da cópia paralela de dados. Os processos gerenciam interrupções temporárias de rede e eleições de cluster, usando sincronização contínua de dados e uma fase final de substituição para obter um tempo de inatividade mínimo. Mecanismos de repetição e validações de pré-migração aumentam a resiliência contra interrupções.
Monitore migrações com atualizações de status em tempo real e notificações.
Métodos de migração em produção
Você pode fazer com que um servidor de migração em produção extraia dados para o Atlas. O método de migração em produção por extração oferece suporte a caminhos de migração entre versões específicas do MongoDB. Consulte Caminhos de migração suportados para aprender mais. Para migrar dados de bancos de dados usando versões não suportadas do MongoDB, consulte Migração legada ou Métodos de migração manuais.
Extraia os dados para o Atlas. O Atlas extrai dados da implantação do MongoDB de origem e requer acesso à implantação de origem por meio do firewall da implantação. Quando os clusters estiverem totalmente sincronizados, você deve seguir o processo de transição para interromper as operações de gravação na origem, redirecionar os aplicativos para o cluster do Atlas e reiniciá-los. As seguintes considerações se aplicam:
Mais indicado para implantações não monitoradas pelo Cloud Manager ou Ops Manager.
O banco de dados de origem deve estar acessível publicamente para permitir o acesso de entrada do servidor de migração em produção.
Não oferece suporte a emparelhamento de VPC ou pontos de extremidade privados para o cluster de origem ou de destino.
As topologias dos clusters de origem e destino devem corresponder. Por exemplo, ambos devem ser conjuntos de réplicas ou clusters compartilhados com o mesmo número de fragmentos.
Planeje para uma indisponibilidade mínima durante a transição, para interromper gravações e reiniciar os aplicativos com uma nova string de conexão. O processo de migração usa intensamente a CPU no cluster de destino e requer uma largura de banda de rede significativa.
Para garantir um processo de migração tranquilo, verifique se o tamanho do oplog do cluster de origem é suficiente para abranger toda a duração da migração. Para o cluster de origem, a janela de atraso da migração em produção deve permanecer dentro dos limites da janela de atraso de replicação do oplog. Você pode cumprir esse requisito aumentando a oplog window mínima ou aumentando o tamanho fixo do oplog. Para o cluster de destino, o MongoDB recomenda que você escolha uma camada do cluster de destino que esteja pelo menos a dois níveis acima do cluster de origem durante a migração. Se o dimensionamento automático de armazenamento estiver desativado no cluster de destino, aumente o tamanho do oplog no cluster de destino para um valor fixo suficientemente alto. Se o dimensionamento automático de armazenamento estiver habilitado no cluster de destino, defina uma oplog window mínima alta o suficiente no cluster de destino. Consulte Requisitos de Oplog para aprender mais.
Para obter recomendações e instruções completas sobre migração, consulte Migração em produção (extração) de um cluster para o Atlas.
Monitoramento de migrações
Para revisar as migrações em andamento e as passadas, navegue até a página Migration Hub no Atlas.
Você pode clicar em cada processo de migração para obter informações mais detalhadas, incluindo a estimativa de tempo inicial de cópia dos dados e relatórios abrangentes de progresso. Use o cartão do cluster para criar, realizar a transição ou para cancelar uma migração.
Para aprender mais, consulte Monitorar migrações.
Métodos de migração manual
Se a migração em produção do Atlas não puder atender aos requisitos de restrições da migração, você pode trazer dados de implantações MongoDB existentes, JSON ou arquivos CSV para o Atlas usando uma das seguintes ferramentas que você executa fora do Atlas.
Ferramenta | Descrição |
|---|---|
O binário Mongosync é o processo primário usado pela migração ao vivo do Atlas. Você pode utilizar o | |
Migre de um conjunto de réplicas do MongoDB para um cluster do Atlas sem desligar seu conjunto de réplicas ou aplicativos existentes. O mongomirror não importa dados de usuário/função nem copia o banco de dados do | |
Propague um cluster do Atlas com um dump de backup de dados | |
Carregue dados de um arquivo | |
Use uma GUI para carregar dados de um arquivo |
Você também pode restaurar dados de backup de um cluster do Atlas para outro cluster do Atlas. Para obter informações, consulte Restaure seu cluster.
Se for necessário usar configurações de emparelhamento Atlas VNet ou Private Link, você não deve permitir a conexão direta de terceiros com o cluster de origem, ou se ainda não tiver ou não quiser importar o cluster de origem no Ops Manager ou Cloud Manager, o MongoDB recomenda a abordagem autônoma de mongosync.
Se você tiver conjuntos de dados relativamente pequenos (< 300 GB) para migrar e puder arcar com o tempo de inatividade do aplicativo por um período longo, o MongoDB recomenda a abordagem mongodump e mongorestore.
Se você tiver conjuntos de dados relativamente pequenos (< 300 GB) para migrar, nenhuma preocupação com índices e pode dispor do tempo de inatividade do aplicativo por um período prolongado, o MongoDB recomenda a abordagem mongoexport e mongoimport.
Transição
Quando uma migração atingir o status "Pronta para transição", clique em Cutover on target cluster seguido por Prepare to Cutover no cartão de cluster para iniciar o processo de transição. Após a conclusão bem-sucedida da transição, reconfigure seu aplicativo para que aponte para o novo cluster de destino.
Para aprender mais, consulte Monitorar migrações.
Próximos passos
Consulte a página Orientações para organizações, projetos e clusters do Atlas para aprender sobre os blocos estruturais do seu patrimônio empresarial Atlas do ou use a navegação à esquerda para encontrar recursos e práticas recomendadas para cada pilar da Well-Architected Framework.