O Mongosync usa 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 do Mongosync:
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.
Versões atualmente suportadas
O MongoDB suporta apenas a versão de patch mais recente de cada versão principal. Por exemplo, mongosync 1.16.0 é a versão de patch mais recente do 1.16. Se você estiver usando uma versão sem suporte do mongosync, poderá ser solicitado que você atualize para receber suporte.
Considerações relacionadas à versão
O Mongosync tem as seguintes considerações relacionadas à versão:
Ciclo de vida do suporte
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 do Mongosync só funcionar com uma versão não compatível do MongoDB Server, essa versão do Mongosync também não será compatível.
Lançamentos de patches
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 2.1.0 do Mongosync 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.
Atualizações ao vivo
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.
Importante
mongosync não suporta atualizações em tempo real para todas as versões. Para ver se você pode fazer a atualização ao vivo para uma versão específica, verifique asnotas de versão dessa versão e consulte a seção Atualizações ao vivo.
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:
(Opcional) Pausar os mongosync processos
Para pausar mongosync, execute pause em cada processo de 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 .
Baixe e instale os novos mongosync binários do
Para baixar e instalar os novos binários do mongosync , consulte baixar e instalar o mongosync.
Inicialize os mongosync processos
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.
Retomar os mongosync processos
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á estivesse em andamento antes da atualização live, os novos recursos adicionados na versão mongosync mais recente podem não ser todos suportados após a atualização live. Melhorias de desempenho e correções de bugs são sempre suportadas após a atualização live.
Metadados persistentes
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.
Mensagens de registro
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.
Exemplos
Os exemplos a seguir ilustram os tipos de alterações que resultariam em cada tipo de atualização do número da versão.
Lançamentos principais
As alterações que fazem com que as versões nova e antiga do
mongosyncproduzam 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
mongosyncnã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
mongosyncrejeite 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.
mongosyncpode 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
mongosyncainda suportar uma versão do Servidor MongoDB que suporta a funcionalidade.Se o
mongosyncjá 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.
Lançamentos menores
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.
Lançamentos de patches
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.