Atualizar a versão principal do MongoDB para um cluster
Nesta página
Você pode atualizar a versão principal do seu cluster do Atlas a qualquer momento, modificando o cluster.
Para garantir que sua transição para a nova versão do MongoDB seja tranquila e não afete seu aplicativo, antes de atualizar a versão principal no seu cluster de produção do Atlas, use o procedimento a seguir para criar um cluster de preparação e testar seu aplicativo na nova versão do MongoDB.
Considerações
As seguintes considerações se aplicam:
Seu cluster deve estar em um estado saudável antes de atualizar.
Se você tirar um instantâneo sob demanda antes de um upgrade de versão principal, aguarde até que o instantâneo seja concluído antes de atualizar a versão.
Você pode somente atualizar seu cluster do Atlas uma versão principal de cada vez. Você não pode ignorar nenhuma versão principal ao atualizar seu cluster.
Cada versão principal contém alguns recursos que podem não ser compatíveis com versões anteriores. Ao atualizar para uma nova versão principal, verifique as Notas de versão do para verificar se há alterações que possam afetar seus aplicativos. Como alternativa, se você usar a Stable API, garantirá que as alterações de comportamento entre as versões do MongoDB não danifiquem seu aplicativo após uma atualização.
A Stable API do MongoDB abrange um subconjunto de comandos do MongoDB que os aplicativos usam para ler e gravar dados, criar coleções e índices e executar outras tarefas comuns. A API Stable permite que você especifique em qual versão da API do MongoDB seu aplicativo é executado e fornece estabilidade de API de longo prazo para aplicativos. Ela é compatível com as versões mais frequentes e atualizações automáticas do servidor, permitindo que seus aplicativos aproveitem os recursos lançados rapidamente sem correr o risco de alterações incompatíveis com versões anteriores.
Depois de atualizar a versão principal do MongoDB , você não poderá fazer o downgrade para versões anteriores, a menos que tenha fixado o FCV do cluster antes da atualização.
A migração live requer que os FCVs nos clusters de origem e destino correspondam na maioria dos casos. Para saber mais,consulte Migrar ou importar dados.
A partir do MongoDB 6.0, a variável de agregação
$$SEARCH_METAnão pode ser usada em nenhum estágio subsequente após um estágio$searchMeta.Se você deseja atualizar para MongoDB 6.0 a partir de uma versão anterior e utilizar a variável de agregação do
$$SEARCH_METAem suas consultas do Atlas Search$searchMeta, revise-as antes de atualizar seu agrupamento para evitar erros.
Acesso necessário
Para atualizar um cluster, você deve ter a função Project Owner ou superior para o projeto.
Atualize sua versão principal do MongoDB
Para atualizar sua versão principal do MongoDB :
No Atlas, VáGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Crie um Atlas cluster para seu ambiente de teste.
Observação
Você pode pular esta etapa se você já tiver um Atlas cluster como seu ambiente de teste.
Clique no botão Create para abrir o modal de criação do cluster. Configure o cluster de preparo para corresponder ao cluster de produção. Não é necessário ativar backups para o cluster de preparo.
Para saber como criar um novo cluster, consulte Criar um cluster.
Importante
Se selecionar uma camada de cluster menor para o cluster de preparo, leve em consideração que qualquer teste de desempenho executado pode não ser representativo do desempenho do cluster de produção atualizado. Talvez você também precise selecionar um tamanho de armazenamento maior, dependendo da quantidade de dados que deseja espelhar para o cluster de preparo.
Atualize o cluster de preparo com dados do cluster de produção.
Observação
Você pode pular esta etapa se você já tiver um Atlas cluster atualizado como um ambiente de preparação.
Se você tiver backups habilitados para o cluster de produção, restaure o snapshot mais recente e escolha o cluster de preparo como destino.
Se você não tiver backups habilitados para o cluster de produção, use o Atlas Live Import para espelhar dados do cluster de produção para o cluster de preparo. A documentação de migração ao vivo inclui instruções específicas para criar ambientes de preparação.
Aponte seu aplicativo de preparação para o cluster de preparo.
Atualize seu aplicativo de preparação para apontar para o cluster de preparação. Para obter instruções sobre como recuperar a cadeia de conexão amigável ao driver do MongoDB para o cluster de preparo, consulte Conecte-se por meio de drivers.
Confirme se o aplicativo pode se conectar com êxito ao cluster de preparo e se o aplicativo opera conforme o esperado.
(Opcional) Atualize seu aplicativo para os drivers MongoDB mais recentes.
Atualizar seu aplicativo para os drivers mais recentes do MongoDB para a versão do MongoDB do cluster permite acesso total aos recursos fornecidos pela versão mais recente do MongoDB. Você também pode encontrar melhor desempenho ou estabilidade com as versões mais recentes do driver. Consulte Conectar via drivers para obter a documentação sobre o driver recomendado do MongoDB para uma determinada versão do MongoDB e exemplos de conexão. Ao usar a Stable API, você pode garantir que as alterações de comportamento entre as versões do MongoDB não quebrem seu aplicativo.
Se você encontrar um bug depois de atualizar seu aplicativo, registre um ticket no projeto JIRA para seu driver MongoDB.
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Atualize o cluster de preparo para a nova versão principal do MongoDB.
Clique em Edit Config e selecione seu cluster de preparação no menu suspenso.
Altere a versão do cluster para a versão MongoDB principal desejada.
Importante
Você não pode fazer downgrade da versão do MongoDB de um Atlas cluster, a menos que o FCV do cluster tenha sido fixado anteriormente antes da atualização. Se quiser reimplantar o ambiente de preparação com a versão original do MongoDB , você deverá encerrar e recriar o cluster.
Clique em Confirm & Deploy para implantar suas alterações.
O Atlas começa automaticamente a atualizar o cluster. Considere medir o tempo necessário pelo Atlas para atualizar o cluster para definir uma expectativa geral para a atualização do cluster de produção.
Registre um ticket de suporte se você encontrar problemas específicos da versão com o cluster de preparo atualizado.
Teste seu aplicativo no cluster de preparo atualizado.
Execute todos os testes operacionais e de desempenho necessários do cluster de preparo.
Registre um ticket de suporte se você encontrar problemas específicos da versão com o cluster de preparo atualizado.
Importante
A atualização da versão principal requer pelo menos uma eleição de conjunto de réplicas Use o cluster de preparo como uma oportunidade para testar a resiliência do seu aplicativo ao failover primário. Consulte Testar failover primário para obter a documentação completa.
Atualize seu cluster de produção para a versão MongoDB de destino.
Quando estiver confiante no desempenho e na operação do cluster de preparo, repita o procedimento de upgrade para o cluster de produção.
Depois que o Atlas concluir o processo de atualização, verifique se seus aplicativos de produção ainda estão conectados e operando normalmente.
Se você atualizou seu aplicativo de teste com drivers mais recentes do MongoDB e está satisfeito com o desempenho e a operação, considere agendar um período de manutenção para atualizar seus aplicativos de produção.
Se você encontrar problemas com o cluster de produção atualizado, registre um ticket de suporte de alta prioridade usando o procedimento na seção a seguir.
Gerenciar compatibilidade de recursos (FCV) durante atualizações
As atualizações da versão principal do MongoDB são suportadas pelos sistemas Atlas e locais. O FCV habilita ou desabilita funcionalidades que persistem em dados incompatíveis com versões anteriores do MongoDB. Você pode fixar o FCV de um cluster antes de atualizar no Atlas, o que permite reverter o MongoDB para a versão anterior após a atualização sem problemas de compatibilidade de versão.
Os procedimentos a seguir permitem fixar e desafixar o FCV para o cluster, fazer o downgrade do cluster em uma versão principal ou arquivar um tíquete de suporte.
Aviso
O FCV é uma medida de curto prazo que só persiste por até 4 semanas após a data de fixação e não simula o comportamento das versões binárias anteriores. Ele apenas adia a atualização de certas estruturas de dados internas que permitem novos recursos de servidor . Quando estiver confiante de que um downgrade para a versão anterior é desnecessário, desmarque o FCV para corresponder à versão binária atual.
Limitações
A pinagemFCV só está disponível em clusters Dedicados.
O PinFCV não pode ser estendido para além de 4 semanas a partir da data do Pin.
A fixação deFCV não é suportada para clusters em rapid release.
Você deve fixar o FCV de um cluster antes que a versão do cluster atinja o fim da vida útil.
Pins o FCV para o seu cluster
Quando o cluster tem um FCV fixado , um ícone de pin aparece ao lado do Version do cluster na parte inferior do cartão do cluster. Se você passar o cursor sobre o ícone de pino, será exibida uma dica de ferramenta que mostra o FCV e a data de expiração.
O Atlas desafixa o FCV do cluster na próxima período de manutenção a partir da data de expiração ou após a data de expiração.
Se você já atualizou a versão MongoDB do seu cluster, o Atlas atualizará seu FCV para corresponder à sua versão MongoDB após o pino expirar.
Para fixar o FCV para o seu cluster:
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Defina a data de expiração.
Todas as datas são definidas como Timestamp no formato 8601 de data e hora ISO em UTC, no MM/DD/YYYY formato . Defina a data de expiração do FCV para dentro de quatro semanas da data em que você fixou o FCV . Quando a data de expiração passa, a dica de ferramenta exibe Expired XX/XX/XXXX. Seu pin FCV expira automaticamente após 4 semanas.
Depois que o pin do FCV expirar, o Atlas desafixará o FCV do seu cluster na próxima período de manutenção a partir da data de expiração ou após a data de expiração. Se você já atualizou a versão MongoDB do seu cluster, o Atlas atualizará seu FCV para corresponder à sua versão MongoDB .
Para fixar o FCV para seu cluster usando a API, consulte Pinar o FCV para um cluster de um projeto.
Retirar o FCV para o seu cluster
Para desafixar o FCV para o seu cluster:
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Faça downgrade do seu cluster por uma versão principal
As seguintes limitações se aplicam ao downgrade da versão do seu cluster:
Você só pode fazer o downgrade se fixar o FCV do cluster antes de atualizar.
Você só pode fazer downgrade do cluster para a versão principal que corresponda ao FCV fixado .
Você só pode executar essa ação se o FCV fixado estiver apenas uma versão principal abaixo do FCV atual e você não tiver a liberação rápida ativada.
Você não pode fazer downgrade para uma versão depois que ela atingir o fim da vida útil.
Para fazer downgrade do cluster em uma versão principal:
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Para fazer downgrade do cluster por uma versão principal usando a API, consulte Modificar um cluster de um projeto.
Entre em contato com o suporte
Se você tiver alguma dúvida sobre o suporte à migração além do que é abordado nesta documentação, ou se encontrar um erro durante a migração, registre um tíquete de suporte por meio da Atlas user interface.
Se tiver alguma dúvida ou precisar de mais ajuda, entre em contato com nossa equipe de suporte.