Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/ /

Atualizar a versão principal do MongoDB para um cluster

Nesta página

  • Considerações
  • Acesso necessário
  • Procedimento
  • Suporte para atualizações de versões principais

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.

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.

Para atualizar um cluster, você deve ter a função Project Owner ou superior para o projeto.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Se ainda não estiver exibido, clique em Clusters na barra lateral.

    A página Clusters é exibida.

2

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.

3

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.

4

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.

5

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.

6
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Se ainda não estiver exibido, clique em Clusters na barra lateral.

    A página Clusters é exibida.

7
  1. Clique em Edit Config e selecione seu cluster de preparação no menu suspenso.

  2. 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.

  3. 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.

8

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.

9

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.

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:

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Ao lado do menu Projects, expanda o menu Options e clique em Project Support.

    A página Suporte ao Projeto é exibida.

2
3

Para Priority, selecione Medium Priority. Se o problema afetar seu cluster de produção, selecione High Priority.

4

Para Request Summary, inclua Major Version Upgrade no resumo.

5

Para More details, inclua quaisquer outros detalhes relevantes para sua pergunta ou erro de atualização da versão principal.

Voltar

Recuperar-se de uma interrupção