Início rápido do Cluster-to-Cluster Sync

Visão geral

A Cluster-to-Cluster Sync do MongoDB conecta clusters do MongoDB e fornece uma maneira de sincronizar dados entre eles. A ferramenta que faz a conexão é mongosync. Para obter mais detalhes, consulte o restante da documentação do Cluster-to-Cluster Sync .

mongosync sincroniza dados entre dois clusters.

• 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 Cluster-to-Cluster Sync, 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"

Sincronizar 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, os clusters estarão sincronizados e o cluster de destino replicará continuamente os dados do cluster de origem.

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.

Sincronização única

Após inicializar a sincronização de dados, chame o endpoint de progresso para ver o status do processo de sincronização:

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

Para uma sincronização única, verifique se a resposta progress inclui os seguintes valores de campo:

• state: "RUNNING"

• canCommit: true

• lagTimeSeconds está próximo de 0 (Recomendado, mas não obrigatório)

Em seguida, chame o endpoint de confirmação para confirmar a operação de sincronização no cluster de destino e interromper a replicação contínua:

curl localhost:27182/api/v1/commit -XPOST --data '{ }'

Se a solicitação commit for bem-sucedida, mongosync retornará { "success": true } e entrará no estado COMMITTING . Após a sincronização ser concluída, mongosync entra no estado COMMITTED e os clusters não estão mais em sincronização contínua.

Verificação de dados

Antes de transferir a carga do seu aplicativo do cluster de origem para o destino, verifique seus dados para garantir que a sincronização foi bem-sucedida.

Para obter mais informações, consulte Verificar a fonte de dados.

Notas de sincronização

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