Menu Docs
Página inicial do Docs
/
Sincronização de Cluster-to-Cluster do MongoDB
/

mongosync Controle de Versão

Nesta página

  • Versões atualmente suportadas
  • Considerações relacionadas à versão
  • Ciclo de vida do suporte
  • Lançamentos de patches
  • Atualização ao vivo
  • Upgrade ou Downgrade não ao vivo
  • Metadados persistentes
  • Mensagens de registro
  • Exemplos
  • Lançamentos principais
  • Lançamentos menores
  • Lançamentos de patches

A Cluster-to-Cluster Sync utiliza a Versão Semântica .2.0.0 Os números de versão têm o formato X.Y.Z, em que X é a versão principal, Y é a versão secundária e Z é a versão do patch.

O MongoDB usa as seguintes diretrizes para determinar quando incrementar o número da versão para Cluster-to-Cluster Sync:

  • Número principal: a versão quebra a compatibilidade com versões anteriores.

  • Número menor: a versão inclui novos recursos significativos que são compatíveis.

  • Número do patch: esta versão inclui apenas pequenas alterações compatíveis com versões anteriores.

O MongoDB suporta apenas a versão de patch mais recente de cada versão principal. Por exemplo, mongosync 1.8.0 é a versão de patch mais recente do 1.8. Se você estiver usando uma versão sem suporte do mongosync, poderá ser solicitado que você atualize para receber suporte.

A Cluster-to-Cluster Sync tem as seguintes considerações relacionadas à versão:

  • As principais versões são suportadas por pelo menos um ano a partir da primeira versão dessa série.

  • Se uma versão da Cluster-to-Cluster Sync funcionar apenas com uma versão sem suporte do MongoDB Server, essa versão da Cluster-to-Cluster Sync também não será compatível.

Somente a versão mais recente de cada série de lançamentos principal recebe novas versões de patch. Por exemplo, quando a versão Cluster-to-Cluster Sync 2.1.0 for lançada, a versão 2.0 não receberá mais versões de patch. Ao mesmo tempo, a versão 1.3 continuaria a receber patches até que a versão 1.4 fosse lançada.

Novidades na versão 1.7.0.

A partir de mongosync 1.7.0, você pode atualizar o mongosync sem reiniciar as operações de sincronização de dados desde o início. Você só pode fazer a atualização ao vivo para mongosync 1.7.3 ou posterior de mongosync 1.7.2 ou mais tarde.

Após a atualização live, o mongosync continua as operações que estavam em andamento antes da atualização.

Para atualizar ao vivo mongosync, execute estas etapas:

1

Para pausar mongosync, execute pause em cada processo mongosync em execução.

Você pode retomar os processos mongosync mais tarde a partir do estado de pausa, como mostrado na etapa final.

Dica

Se você não quiser retomar imediatamente as operações de sincronização de dados após a atualização live, considere pausar os processos do mongosync . Isso é útil se você estiver coordenando operações de vários processos do mongosync .

2

Use seu sistema operacional para interromper cada processo do mongosync em execução. Para interromper um processo, consulte a documentação do sistema operacional para obter as etapas específicas.

3

Para baixar e instalar os novos binários do mongosync , consulte baixar e instalar o mongosync.

4

Para inicializar os processos do mongosync , consulte Início Rápido. Durante a inicialização após uma atualização live, mongosync atualiza os metadados persistentes.

5

Se você pausou algum processo mongosync anteriormente na primeira etapa opcional, execute resume em todos os processos mongosync .

Se uma operação de sincronização de dados já estava em andamento antes da atualização live, as novas funcionalidades adicionadas na versão mongosync mais recente podem não ser suportadas após a atualização live. Melhorias de desempenho e correções de bugs são sempre suportadas após a atualização ao vivo. Para obter mais informações sobre os novos recursos que podem ser suportados após uma atualização live, consulte a versão 1.7.0.

Se você estiver usando uma versão anterior do mongosync não suportada pelo procedimento de atualização live, ou se precisar fazer o downgrade do mongosync, execute estas etapas:

  • Pare todos os processos mongosync atualmente em execução.

  • Solte todos os reconhecimento de data center que não sejam do sistema no cluster de destino.

  • Instale novos binários do mongosync .

  • Inicie os processos do mongosync utilizando os novos binários.

Aviso

Os novos processos de mongosync não retomam nenhum trabalho que possa estar em andamento. A sincronização das operações é reiniciada desde o início quando você inicia os novos processos.

Durante a operação normal, o mongosync cria metadados que são persistidos no disco no reconhecimento de data center de destino. Esses metadados não são versionados e podem ser alterados a qualquer momento.

Os formatos das mensagens de registro não têm controle de versão e podem ser alterados a qualquer momento. Isso inclui alterações no texto da mensagem, bem como a presença, ausência ou conteúdo de outros campos da mensagem.

Os scripts e aplicativos do usuário não devem depender do registro da saída. Os scripts e aplicativos devem usar a API de monitoramento para determinar o estado atual do mongosync.

Os exemplos a seguir ilustram os tipos de alterações que resultariam em cada tipo de atualização do número da versão.

  • As alterações que fazem com que as versões nova e antiga do mongosync produzam resultados diferentes no cluster de destino para o mesmo conjunto de entradas. Exceto:

    • Correções de erros para casos em que a versão mais antiga do mongosync não replica os dados.

    • Quando o comportamento anterior é explicitamente documentado como não suportado.

  • Alterações nos parâmetros CLI documentados ou chaves de configuração de modo que mongosync rejeite a entrada anteriormente válida. Exceto:

    • Correções de erros, como análise ou erros de tipo.

    • Embora os parâmetros CLI ou chaves de configuração possam ser preteridos, o significado dos parâmetros CLI documentados ou chaves de configuração nunca mudará. Se necessário, novos parâmetros ou chaves substituirão as entidades mais antigas e obsoletas.

  • Alterações que quebram a compatibilidade com uma versão suportada do MongoDB Server.

  • Descartando uma versão da REST API. mongosync pode descartar todos os endpoints mais antigos em favor de uma nova versão da API. Nunca haverá outros tipos de alterações incompatíveis com versões anteriores na REST API.

  • Removendo o suporte para uma funcionalidade do Servidor MongoDB suportada anteriormente se o mongosync ainda suportar uma versão do Servidor MongoDB que suporta a funcionalidade.

  • Se o mongosync já suportar uma versão principal do Servidor MongoDB, as alterações que exigem novos privilégios de acesso para continuar suportando esta versão do Servidor MongoDB.

  • Adiciona suporte para uma versão do MongoDB Server anteriormente incompatível.

  • Exigindo novo privilégio de acesso para uma versão principal não suportada anteriormente do MongoDB Server.

  • Adicionando suporte para tipos de collection não suportados anteriormente.

  • Adicionando suporte para tipos de índice não suportados anteriormente.

  • Adicionar novos endpoints, novo campo ou novas entradas aceitas na REST API.

  • Adicionando novas opções de CLI documentadas.

  • Adicionando novas chaves de configuração ou valores aceitos.

  • Correções de bugs compatíveis com versões anteriores.

  • Correções de regressão de desempenho.

  • Melhorias no desempenho.

  • Alterações para ajudar as strings de texto.

  • Alterações nas sequências de texto de registro.

  • Alterações no texto informativo em respostas de API, mas não alterações em campo de caracteres no estilo enumeração, como "estado".

  • Correções de erros de digitação.

Voltar

Usar o verificador de migração