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.
Após atualizar a versão principal do MongoDB, você não poderá fazer downgrade para versões anteriores.
A partir do MongoDB 6.0, a variável de agregação
$$SEARCH_META
nã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_META
em 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.
Procedimento
No Atlas, acesse 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á Clusters para a 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 reduzir a versão MongoDB de um Atlas cluster. 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.
Suporte para atualizações de versões principais
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.
Como arquivar um ticket de suporte:
No Atlas, vá para a Project Support página .
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.
Ao lado do menu Projects, expanda o menu Options e clique em Project Support.
A página Suporte ao Projeto é exibida.