mongosync. Consulte a documentação atual para obter orientações atualizadas sobre mongosync e instruções sobre como atualizar para a versão mais recente.O Mongosync usa 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 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.11.0 é a versão de patch mais recente do 1.11. 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.
Atualizar ou Rebaixar
Use as etapas a seguir para fazer upgrade ou downgrade do mongosync:
Pare todos os processos
mongosyncatualmente 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
mongosyncutilizando 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.
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.