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.
Se você atualizar seu cluster de versões anteriores para o MongodB 8.0, esteja ciente do comportamento de bloqueio de gravação no Atlas. Para garantir que as gravações do nó primário do cluster dedicado não sejam bloqueadas assim que você atualizar para o MongoDB 8.0:
Verifique se o cluster tem capacidade de armazenamento suficiente para lidar com seu volume de trabalho após a atualização.
Ative o dimensionamento automático de armazenamento, que dimensiona automaticamente o armazenamento do cluster quando a utilização do disco excede 90% e garante disponibilidade e desempenho consistentes da carga de trabalho.
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 deversão do para verificar se há alterações que possam afetar seus aplicativos.
Como alternativa, se você usar a API estável, certifique-se de que as alterações de comportamento entre as versões do MongoDB não quebrem seu aplicação após uma atualização.
A API estável do MongoDB engloba um subconjunto de comandos do MongoDB que os aplicativos usam para ler e escrever dados, criar coleções e índices e executar outras tarefas comuns. A API estável:
Permite que você especifique em qual versão da API do MongoDB seu aplicação é executado e fornece estabilidade de API a longo prazo para os aplicativos.
Suporta 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 menos que tenha fixado o FCV do cluster antes de atualizar.
A migração em produção exige que as versões de compatibilidade do recurso - FCVs nos clusters de origem e de destino correspondam às suas versões principais. Para aprender mais sobre os caminhos de migração compatíveis, 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 o MongoDB 6.0 a partir de uma versão anterior e utilizar a
$$SEARCH_METAvariável de agregação do em suas queries do MongoDB$searchMetaSearch, 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.
AVISO: Melhorias de navegação em andamento No momento, estamos implementando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na IU do Atlas, consulte a documentação de visualização.
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.
Aponte seu aplicativo de preparação para o cluster de preparo.
Atualize seu aplicação de preparação para ponto para o cluster de preparação. Para obter instruções sobre como recuperar a string de conexão amigável ao driver do MongoDB para o cluster de preparo, consulte Conectar-se a um cluster 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 aplicação 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-se a um cluster 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 API estável, você pode garantir que as alterações de comportamento entre as versões do MongoDB não quebrem seu aplicação.
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.
AVISO: Melhorias de navegação em andamento No momento, estamos implementando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na IU do Atlas, consulte a documentação de visualização.
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:
Atualize seu aplicação de produção com drivers MongoDB mais recentes e teste se ele opera normalmente. Esta etapa garante que seu aplicação seja compatível com a nova versão MongoDB antes da atualização do banco de dados .
Depois de preparar o aplicação, atualize a versão do MongoDB no cluster de produção. Quando o Atlas concluir a atualização, verifique se seus aplicativos conectam e operam normalmente.
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.
FCV A fixação do FCV não pode ser estendida para além de 4 semanas a partir da data da fixação.
A fixação deFCV não é suportada para clusters em rapid release.
Você não pode atualizar para uma versão que esteja 2 versões acima da versão FCV fixada. Se um cluster estiver fixado no FCV 6.0, você só poderá atualizar para 7.0, não 8.0+.
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.
AVISO: Melhorias de navegação em andamento No momento, estamos implementando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na IU do Atlas, consulte a documentação de visualização.
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 de data e hora ISO 8601 em UTC, no formato MM/DD/YYYY. Defina a data de expiração da versão de compatibilidade do recurso para estar dentro de quatro semanas da data em que você fixou a versão de compatibilidade do recurso. Quando a data de validade expirar, a dica de ferramenta exibirá Expired XX/XX/XXXX. Seu versão de compatibilidade do recurso 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.
AVISO: Melhorias de navegação em andamento No momento, estamos implementando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na IU do Atlas, consulte a documentação de visualização.
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.
AVISO: Melhorias de navegação em andamento No momento, estamos implementando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na IU do Atlas, consulte a documentação de visualização.
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.