A página MongoDB Software Lifecycle Schedules descreve as versões compatíveis e as datas de fim de vida útil para lançamentos do MongoDB Server. Dependendo do tipo de cluster, o Atlas oferece diferentes opções de gerenciamento de versões. Para clusters dedicados, o Atlas oferece duas opções de cadência de lançamento: versões principais ou atualizações contínuas usando Latest Version With Auto Upgrades. Os clusters Free e Flex não permitem que você escolha uma cadência de lançamento; eles permanecem em uma versão principal (atualmente, MongoDB 8.0), e o Atlas os atualiza automaticamente.
Para a maioria das implantações do Atlas, Latest Version With Auto Upgrades é a melhor maneira de receber os recursos e aprimoramentos mais recentes do MongoDB automaticamente à medida que o Atlas os lança. No entanto, você pode optar por um controle de versão mais rígido e optar por permanecer em uma versão principal específica.
Para aprender mais sobre as versões do MongoDB Server em geral, consulte Versões do MongoDB.
Versão mais recente com upgrades automáticos
Quando você escolhe a versão do cluster e seleciona Latest Version With Auto Upgrades, o Atlas atualiza automaticamente o cluster para a versão principal ou secundária mais recente do MongoDB, ativa novos recursos à medida que eles se tornam disponíveis e atualiza as versões de patch por meio de um processo contínuo para manter a disponibilidade do cluster.
Na maioria dos casos, recomendamos optar pela atualização automática da versão. Isso significa que o Atlas mantém seu cluster atualizado e evita que você precise acompanhar o cronograma de lançamento do MongoDB. Ao escolher Latest Version With Auto Upgrades, você não pode selecionar uma versão principal, versão secundária ou versão de patch específica.
Alternando de atualizações automáticas para uma versão principal
Se o seu cluster estiver em uma versão secundária enquanto estiver em Latest Version With Auto Upgrades, você poderá alternar para uma cadência de versão principal somente quando a próxima versão principal estiver disponível.
Por exemplo, se você optar por participar enquanto o MongoDB 8.2 for 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ê pode voltar para uma cadência de versão principal apenas na janela entre o lançamento 9.0 e o primeiro 9.x liberação menor. Se você perder essa janela, deverá aguardar até o próximo ciclo de lançamento principal.
Importante
A migração em produção e o Mongosync não são suportados em versões secundárias e, portanto, não funcionarão se o cluster usar Latest Version With Auto Upgrades. Para migrar um cluster que está atualmente em uma versão secundária, use ferramentas de migração autoguiadas.
Versão principal
Se você precisar permanecer em uma versão estável e manter o controle das atualizações de versão principal, você pode optar por permanecer em uma versão principal. Você pode atualizar a versão principal do seu cluster do Atlas a qualquer momento, modificando o cluster. As versões principais também recebem automaticamente atualizações de versão de patch.
Antes de atualizar uma versão principal em produção, teste seu aplicativo em um cluster de staging e revise as alterações de compatibilidade nas notas da versão. Se aplicável, confie na Stable API.
Fim da vida útil para uma versão principal
O Atlas envia uma notificação por e-mail pelo menos seis meses antes que uma versão do MongoDB atinja o fim da vida útil. Você também pode encontrar as informações na página MongoDB Software Lifecycle Schedules. Após a data limite, o Atlas atualiza seus clusters para a próxima versão do MongoDB, a menos que você solicite e receba aprovação para uma extensão. Atualize seu cluster antes da data limite para garantir que seus serviços e aplicativos não sofram tempo de inatividade ou problemas de compatibilidade com a nova versão do MongoDB.
Disponibilidade da versão
A tabela a seguir mostra as versões do MongoDB disponíveis para cada tipo de cluster.
Versão | Disponível em M10+ | Disponível nos clusters M0 e Flex |
|---|---|---|
MongoDB 7.0 | ||
MongoDB 8.0 | ||
MongoDB 8.3 * |
- A versão 8.3 está disponível apenas para clusters com Latest Version With Auto Upgrades.
Importante
Se o projeto tiver uma função personalizada que utilize ações introduzidas em uma versão MongoDB específica, você não poderá criar um cluster com uma versão MongoDB inferior, a não ser que você exclua a função personalizada.
Selecione ou altere a versão do cluster
Importante
Antes de atualizar o cluster, revise as melhores práticas recomendadas para atualizações de versão principal.
Para selecionar ou alterar a versão do cluster:
Abra a configuração do cluster.
Para definir a versão de um novo cluster, conclua as etapas para criar um cluster e expanda Additional Settings.
Para alterar a versão de um cluster existente, clique em Edit Config para abrir o formulário do cluster e expanda Additional Settings.
Selecione uma versão.
No menu suspenso Select a version, selecione a versão do seu cluster.
O Atlas suporta os seguintes caminhos de atualização:
MongoDB 7.0 para MongoDB 8.0
MongoDB 8.0 para a versão mais recente com upgrades automáticos
O Atlas sempre faz upgrade do cluster para a versão de patch mais recente da versão principal especificada. O upgrade usa um processo de atualização gradual para manter a disponibilidade do cluster.
Você não pode fazer downgrade do cluster para uma versão anterior do MongoDB, a menos que tenha fixado o FCV do cluster antes da atualização.
Você pode alternar entre utilizar o Latest Release e utilizar uma versão específica somente se a versão MongoDB mais recente for uma versão principal.