mongosync
Controle de Versão
Nesta página
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.
Versões atualmente suportadas
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.
Considerações relacionadas à versão
A Cluster-to-Cluster Sync 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 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.
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 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.
Atualização 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. 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:
(Optional) Pause the mongosync
processes
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
.
Download and install the new mongosync
binaries
Para baixar e instalar os novos binários do mongosync
, consulte baixar e instalar o mongosync.
Initialize the mongosync
processes
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.
Resume the mongosync
processes
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.
Upgrade ou Downgrade não ao vivo
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.
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
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.
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.