Importante
Sempre atualize para a versão de patch estável mais recente da sua série de lançamentos.
A versão do MongoDB tem o formulário X.Y.Z onde o X.Y se refere à série de versão e o Z se refere ao número do patch.
Começando com MongoDB 8.2, O MongoDB adota uma nova estratégia de controle de versão e lançamento para simplificar os caminhos de atualização e fornecer opções de controle de versão mais claras. O MongoDB é lançado como duas séries de versões diferentes:
Lançamentos principais
Lançamentos menores
Lançamentos principais
As principais versões são disponibilizadas aproximadamente uma vez por ano e introduzem novas funcionalidades e melhorias. As principais versões são suportadas para o MongoDB Atlas e sistemas locais.
Versões de exemplo:
7.08.0
Lançamentos menores
Versões menores introduzem melhorias incrementais e novas funcionalidades dentro de um ciclo de lançamento de versão principal. Elas são tão estáveis quanto as principais versões e adequadas para volumes de trabalho de produção.
A partir do MongoDB 8.2, versões secundárias também estarão disponíveis para sistemas locais (Community e EA) para casos de uso específicos, como Search, Vector Search e recursos aprimorados de Queryable Encryption .
Versões de exemplo:
8.2
Observação
Para o ciclo de lançamento do 8.0, o MongoDB 8.2 está disponível para sistemas Atlas e on-premises. No MongoDB Atlas, o 8.2 é suportado até a próxima versão menor.
Caminho de atualização
Para atualizar entre versões secundárias, você deve atualizar sequencialmente por meio de cada versão secundária. Você não pode ignorar versões menores. Por exemplo, para atualizar de 8.1 para 8.3, você deve primeiro atualizar de 8.1 para 8.2 e, em seguida, atualizar de 8.2 para 8.3.
Para atualizar de uma versão menor para a próxima versão principal, você pode:
Atualize através de cada versão menor para a próxima principal. Por exemplo, para atualizar de 8.1 para a próxima versão principal, atualize de 8.1 para 8.2, de 8.2 para 8.3 e, em seguida, de 8.3 para a próxima versão principal .
Faça o downgrade para a versão principal anterior e, em seguida, atualize para a próxima versão principal. Por exemplo, para atualizar de 8.1 para a próxima versão principal, faça downgrade de 8.1 para 8.0 e, em seguida, atualize de 8.0 para a próxima versão principal.
Cada etapa de upgrade ou downgrade requer uma atualização binária e uma atualização da versão de compatibilidade do recurso.
Opções de versão para MongoDB Atlas
A partir do MongoDB 8.2, duas opções de versão estão disponíveis para clusters dedicados do Atlas :
Versões principais: você pode optar por permanecer em uma versão principal específica, como MongoDB 8.0. Os clusters nas versões principais recebem correções de bugs e patches de segurança. Você deve atualizar manualmente os clusters antes do fim da vida útil (EOL). Caso contrário, o Atlas atualiza automaticamente os clusters para a versão principal suportada mais recente após o EOL.
Versão mais recente com atualizações automáticas: se você definir seu cluster para esta opção de versão, ele receberá atualizações automáticas para a versão mais recente disponível do MongoDB e habilitará novas funcionalidades.
Para saber mais sobre como atualizar manualmente seu cluster do Atlas , consulte Atualizar um cluster para uma nova versão do MongoDB .
Importante
Se você escolher a opção de lançamento Latest Version With Auto Upgrades e seu cluster atualizar de uma versão principal para uma versão secundária, não será possível reverter para uma versão principal até que a próxima versão principal esteja disponível.
Por exemplo, se você optar por usar enquanto o MongoDB 8.2 é a versão mais recente, seu cluster permanecerá na versão secundária mais recente até que o MongoDB 9.0 seja lançado. Você só pode reverter para uma versão principal na janela entre a versão 9.0 e a primeira versão secundária (9.1). Se você perder essa janela, não poderá reverter até que o MongoDB 10.0 seja lançado.
Observação
Você não pode escolher uma opção de lançamento para clusters nas camadas Free e Flex, pois esses clusters são atualizados automaticamente.
Lançamentos de patches
As versões de patch são disponibilizadas conforme necessário para as versões principais e secundárias. As versões de patch geralmente incluem correções de bugs e pequenas melhorias.
Versões de exemplo:
8.0.1(uma versão do patch de versão principal)8.2.1(uma versão do patch de versão menor)
Liberar liberações de candidatos (RC)
Antes das novas liberações principais e secundárias, as liberações candidatas são disponibilizadas para testes iniciais. Uma liberação candidata representa uma versão da próxima liberação que é estável o suficiente para ser usada para testes, mas não é adequada para a implantação na produção.
Versões de exemplo:
6.0.0-rc06.0.0-rc16.1.2-rc5
Versões do driver
O sistema de numeração de versões do MongoDB é diferente do sistema usado para os drivers do MongoDB.
MongoDB Shell (mongosh)
O shell MongoDB (mongosh) é lançado separadamente do MongoDB Server e usa seu próprio sistema de numeração de versão.
Ferramentas de banco de dados
As MongoDB Database Tools são lançadas separadamente do MongoDB Server e usam seu próprio sistema de numeração de versão.