Início rápido do Mongosync

Visão geral

O Mongosync replica dados e grava de um cluster para outro até que a sincronização seja finalizada. Você pode usar essa ferramenta para realizar migrações de dados únicas entre clusters MongoDB com o mínimo de tempo de inatividade.

Para obter mais informações sobre mongosync e o comportamento do cluster de destino durante a execução, consulte Considerações durante a sincronização.

O binário mongosync é o principal processo usado no Mongosync.

• Cada cluster pode ser um conjunto de réplicas ou um cluster fragmentado. Se qualquer um for um cluster fragmentado, consulte as limitações do cluster fragmentado para mongosync.

• Não é necessário que os clusters fragmentados tenham o mesmo número de shards.

• O cluster de destino deve ser da mesma versão ou até duas versões à frente do cluster de origem. A versão de patch não é importante, desde que atenda aos requisitos mínimos de versão de patch.

• O cluster de origem pode permanecer ativo até a confirmação porque mongosync sincroniza as gravações no cluster de origem durante a migração até que a confirmação seja chamada.

Siga as instruções abaixo para configurar o Mongosync, conectar seus clusters e sincronizar seus dados.

Configurar

Conectar os clusters

mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]

cluster0:
mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020
cluster1:
mongodb://clusterAdmin:superSecret@clusterTwo01.fancyCorp.com:20020,clusterTwo02.fancyCorp.com:20020,clusterTwo03.fancyCorp.com:20020

./bin/mongosync \
      --logPath /var/log/mongosync \
      --cluster0 "mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020" \
      --cluster1 "mongodb://clusterAdmin:superSecret@clusterTwo01.fancyCorp.com:20020,clusterTwo02.fancyCorp.com:20020,clusterTwo03.fancyCorp.com:20020"

Migrar dados entre clusters

O endpoint inicial inicia a sincronização de dados. Para iniciar a sincronização, use curl ou um programa semelhante para emitir a solicitação de início :

curl localhost:27182/api/v1/start -XPOST \
--data '
   {
      "source": "cluster0",
      "destination": "cluster1"
   } '

Se a solicitação de início for bem-sucedida, mongosync retornará { "success": true } e iniciará a sincronização dos dados existentes no cluster de origem com o cluster de destino. Nesse ponto, mongosync entra no estado RUNNING e aplica gravações do cluster de origem subsequentes no cluster de destino.

Para verificar o status da sincronização, ligue para o endpoint de progresso :

curl localhost:27182/api/v1/progress -XGET

Se a resposta progress incluir o campo canCommit: true, você poderá chamar o endpoint /commit . Consulte Finalizar processo de transição.

A interface de comando para mongosync é um servidor HTTP que publica uma API HTTP. Para controlar o mongosync, use os pontos de conexão da API. A documentação da API fornece detalhes sobre como usar os seguintes endpoints:

Finalize o processo de transição

Você pode finalizar uma migração e transferir o volume de trabalho do seu aplicação do cluster de origem para o de destino usando o processo de cutover do mongosync .

Para obter mais informações, consulte Finalizar processo de transferência.

Notas

• A porta padrão para a API HTTP é 27182. Utilize a opção --port com mongosync para configurar outra porta.

• mongosync pode trocar os clusters de origem e destino para habilitar a sincronização reversa.

  Para obter mais informações, consulte o ponto de extremidade reverse .

• O usuário especificado na string de conexão mongosync deve ter as permissões necessárias nos clusters de origem e destino. As permissões variam dependendo do seu ambiente e se você deseja executar um bloqueio de gravação ou sincronização reversa.

  Para determinar as permissões de usuário corretas para seu caso de uso, consulte Permissões de Usuário.

• Talvez seja necessário aumentar o descritor de arquivo ulimits no host que está executando mongosync. Isso se aplica a qualquer sistema do tipo UNIX, mas o macOS em particular tem padrões baixos. Consulte Configurações de ulimit do UNIX.

• Para estimar o tamanho do oplog necessário para a sincronização inicial, consulte Dimensionamento do oplog.