O MongoDB lança novas versões em uma cadência regular. Como você recebe essas versões e quanto controle você tem sobre o tempo dependem de como você executa MongoDB. Dependendo do seu tipo de sistema, você deve se preparar para executar uma nova versão de maneiras diferentes.
Esta página explica o que média os números de versão do MongoDB , quais são os tipos de versão e como as atualizações funcionam em termos gerais. Para obter os procedimentos e políticas específicas da sua implementação, consulte os links fornecidos no documento.
Como as versões do MongoDB são numeradas
Os números de versão do MongoDB assumem o formato X.Y.Z:
X é a versão principal. Uma alteração aqui indica uma versão que pode incluir alterações incompatíveis com versões anteriores e novas funcionalidades que persistem dados em formatos que versões anteriores não podem ler.
Y é a versão secundária. Versões secundárias fornecem recursos incrementais entre versões principais, e a disponibilidade depende do seu tipo de sistema.
Z é a versão do patch. As versões de patch contêm correções e são compatíveis com versões anteriores dentro de sua série de versões.
A versão dos Drivers, doMongoDB Shell e das Database Tools do MongoDB independentemente do servidor de banco de dados . Um número de versão do driver não corresponde a um número de versão do servidor . Para saber quais versões de driver funcionam com quais versões de servidor , consulte a página de compatibilidade do seu driver.
Tipos de versão
Lançamentos principais
As principais versões introduzem novas funcionalidades e podem incluir alterações incompatíveis com versões anteriores. O MongoDB suporta as principais versões para o Atlas e sistemas autogerenciados.
Lançamentos menores
Versões menores fornecem recursos em uma cadência mais rápida entre as versões principais.
A partir do MongoDB 8.2, versões menores estão disponíveis para sistemas autogerenciados do Atlas Core Auto Upgrade, Enterprise Advanced e Community.
A partir do MongoDB 9.0, as versões secundárias estão disponíveis somente por meio do Atlas Core Auto Upgrade e não estão disponíveis para o Atlas Core Manual Upgrade e sistemas autogerenciados. Para versões de recursos incrementais, consulte Versões de atualizações de recursos.
Observação
Versões menores podem não suportar todas as funcionalidades, principalmente migração em produção do Atlas e mongosync.
Lançamentos de atualizações de recursos
A partir do MongoDB 9.0, as versões de atualização de recursos são uma versão menor anual, numerada x.5, disponível para Atlas e sistemas autogerenciados. As versões de atualização de recursos oferecem à atualização manual do Atlas Core e aos sistemas autogerenciados uma maneira de obter recursos incrementais sem esperar pela próxima versão principal. Eles carregam a mesma linha do tempo de fim de vida útil e elegibilidade ao Extended Lifecycle Support que a versão principal que eles estendem.
Importante
Para receber todas as versões secundárias no MongoDB 9.0 e posterior, configure seu cluster do Atlas para Latest Version With Auto Upgrades. Todos os outros sistemas são elegíveis apenas para a versão de atualização de recursos, não para outras versões secundárias.
Lançamentos de patches
As versões de patch contêm correções e são compatíveis com versões anteriores somente dentro de sua própria série de versões principais e secundárias. Você deve sempre executar a versão de patch mais recente para sua versão principal e secundária.
Lançar candidatos
Os candidatos a lançamento são compilações de pré-lançamento destinadas a avaliar novos recursos. Eles não são adequados para sistemas de produção.
Para saber mais sobre como os números do MongoDB e as versões do cronograma, consulte Versões do MongoDB .
Como as versões chegam ao seu sistema
As versões do MongoDB chegam ao Atlas antes de ficarem disponíveis para implementações autogerenciadas.
Importante
Um cluster de Atualização Automática do Atlas Core configurado para receber as versões mais recentes pode executar uma versão antes que essa versão esteja disponível para download e instalação por conta própria.
O que isso significa na prática depende de como você executa o MongoDB:
Os clusters do Atlas Core Manual Upgrade permanecem em uma cadência de versão principal que você controla.
Os clusters do Atlas Core Auto Upgrade recebem novas versões automaticamente à medida que o Atlas os distribui.
As implementaçõesautogerenciadas (Enterprise Advanced ou Community) permitem escolher quando baixar e instalar cada versão. Nada muda até que você aja.
Versão de compatibilidade de recursos
Atualizar os binários MongoDB e habilitar os recursos da nova versão são duas etapas separadas.
A versão de compatibilidade do recurso (FCV) controla se os recursos que gravam dados em um formato que versões anteriores não podem ler estão ativados. Depois de atualizar os binários, seu sistema continua a ser executado no FCV anterior até que você o aumente. Isso é deliberado. Enquanto o FCV permanecer na versão anterior, você manterá a capacidade de fazer o downgrade.
Observação
Na atualização automática do Atlas Core, o Atlas atualiza automaticamente o FCV para corresponder a cada nova versão do MongoDB após uma revisão automatizada dos sinais de lançamento dos binários do MongoDB . Você não controla o FCV.
Aumentar o FCV é o ponto sem retorno. Depois que os recursos que persistem dados no novo formato estiverem ativados, não é possível fazer downgrade no Atlas.
Para obter a referência de comando, consulte setFeatureCompatibilityVersion no Manual do MongoDB . Para saber como o FCV funciona no Atlas, incluindo a fixação do FCV antes de uma atualização, consulte Atualizar a versão principal do MongoDB para um cluster.
Ciclo de vida e fim da vida útil do suporte
Cada versão principal do MongoDB é suportada por cinco anos, com um período opcional de Suporte Estendido ao Ciclo de Vida (ELS) de dois anos disponível para clientes do Enterprise Advanced. Quando uma versão chega ao fim da vida útil, ela não recebe mais correções, incluindo correções de segurança, e o MongoDB não mantém mais sua documentação.
O manuseio difere de acordo com o tipo de sistema:
No Atlas, o MongoDB notifica você sobre a data limite da versão antes que ela atinja o fim da vida útil. Após essa data, o Atlas atualiza seus clusters para a versão de destino padrão atual do MongoDB.
Importante
A versão de destino padrão atual do MongoDB nem sempre é a versão principal imediatamente seguinte.
As implementações autogerenciadas exigem que você atualize antes do fim da vida útil.
Para ver quais versões são atualmente compatíveis em quais plataformas, consulte Plataformas compatíveis com o MongoDB Enterprise ou Plataformas compatíveis com o MongoDB Community.
Escolha seu caminho de atualização
Se você executar | Cadência da versão | Comece por aqui |
|---|---|---|
Atualização manual do Atlas Core | Você escolhe quando passar para a próxima versão principal. | |
Atualização automática do Atlas Core | O Atlas atualiza você automaticamente. Use as levas de manutenção para controlar a ordem nos ambientes. | |
Enterprise Advanced | Você escolhe quando. | |
Community | Você escolhe quando. |
Considerações sobre atualização autogerenciada
Para implementações autogerenciadas, os procedimentos de atualização diferem de acordo com a topologia. A página de atualização de cada versão está vinculada a procedimentos de cluster autônomo, de conjunto de réplicas e de cluster fragmentado .
Nas versões do MongoDB anteriores a 9.0, você não pode ignorar versões secundárias ao atualizar uma implantação autogerenciada. Para alternar entre versões menores, você deve atualizar cada uma delas em sequência.
A partir do MongoDB 9.0, as implantações do Enterprise Advanced recebem apenas a versão anual da Atualização de Recursos, além das versões principais. Não há mais uma sequência de menores a serem ignorados em um ciclo de lançamento.
Antes de atualizar
Qualquer que seja o seu tipo de sistema, três coisas valem a pena fazer antes de uma atualização de versão principal:
Teste seu aplicação na nova versão antes que ela chegue à produção.
Como você faz isso depende do seu sistema:
Autogerenciado: primeiro, atualize um sistema que não seja de produção.
Atualização manual do Atlas Core: crie um cluster de preparo executando a versão de destino e teste com ela. Consulte Atualizar a versão principal do MongoDB para um cluster.
Atlas Core Auto Upgrade: você pode usar Ondas de manutenção para sequenciar os ambientes de preparação e produção, mas elas podem não interromper o lançamento e não dão controle total sobre o tempo de atualização.
Importante
Se você precisar de mais tempo para validar uma versão, use uma cadência de versão principal. Para saber mais sobre as levas de manutenção, consulte Gerenciar a manutenção de clusters.
Downgrades
O downgrade é limitado e as restrições diferem de acordo com o tipo de sistema. Selecione seu tipo de sistema para ver as restrições que se aplicam a você.
A desatualização exige que o FCV não tenha sido aumentado ou tenha sido fixado antes da atualização original.
Um cluster pode fazer downgrade apenas para a versão imediatamente anterior, a versão principal anterior ou a versão de atualização de recursos dessa versão principal, e os downgrades não podem ser encadeados em várias versões.
Um cluster em uma versão de Atualização de Recursos pode fazer downgrade para sua própria versão principal.
Com muito poucas exceções, um downgrade atinge a versão de patch mais recente da versão de destino.
Após um downgrade, os recursos introduzidos na versão mais recente não estão mais disponíveis, e o MongoDB não suporta um segundo downgrade da nova posição inferior.
Você não pode fazer downgrade de clusters.
Observação
Para migrar para uma cadência de versão principal elegível para downgrades, alterne como uma ação de autoatendimento após o lançamento da versão principal (
x.0.0) e antes da primeira versão secundária desse ciclo (x.1.0). Para saber mais, consulte Versão mais recente com atualizações automáticas.
- As desatualizações são suportadas somente entre versões adjacentes e exigem procedimentos específicos para sua configuração de cluster.
A desatualização exige que o FCV não tenha sido aumentado ou tenha sido fixado antes da atualização original.
Um cluster pode fazer downgrade apenas para a versão imediatamente anterior, a versão principal anterior ou a versão de atualização de recursos dessa versão principal, e os downgrades não podem ser encadeados em várias versões.
Um cluster em uma versão de Atualização de Recursos pode fazer downgrade para sua própria versão principal.
Com muito poucas exceções, um downgrade atinge a versão de patch mais recente da versão de destino.
Após um downgrade, os recursos introduzidos na versão mais recente não estão mais disponíveis, e o MongoDB não suporta um segundo downgrade da nova posição inferior.
Saiba mais
Versões do MongoDB para numeração e cadência de lançamento em detalhes
Notas de versão para notas de versão por versão, alterações de compatibilidade e procedimentos de upgrade e downgrade
Versões do MongoDB no Atlas para ver as opções de cadência de liberação do Atlas
MongoDB Atlas Core: Visão Geral e MongoDB Atlas Infinite: Visão Geral para saber mais sobre as edições do banco de dados Atlas