Migre suas Ferramentas Programáticas de M2, M5 ou Instâncias sem Servidor para Flex Clusters

Importante

A partir de 2025 de fevereiro, você pode criar clusters flexíveis e não pode mais criar clusters M2 e M5 ou instâncias sem servidor na UI do Atlas , Atlas CLI, Atlas Administration API, Atlas Kubernetes Operator, HashiCorp Terraform , ou recursos do Atlas CloudFormation.

O Atlas não suporta mais clusters do M2 e M5 e instâncias sem servidor. A partir de 25 de maio de 2025, o Atlas migrou todos os clusters M2 e M5 existentes para clusters do Flex.

O Atlas migrou instâncias sem servidor para clusters gratuitos, clusters flexíveis ou clusters dedicados de acordo com seu uso. Para ver para quais níveis o Atlas migrou suas instâncias, consulte a página Todos os clusters na interface do usuário do Atlas .

Todas as ferramentas suportam clusters Flex. Atualize seu código e substitua todas as referências a tipos de instância obsoletos por referências a Flex Clusters.

Observação

Se suas cargas de trabalho exigirem endpoints privados ou backup contínuo e restauração point-in-time, use clusters dedicados.

Migrando configuração da API

Os endpoints da API de Cluster listados na tabela nesta seção são compatíveis com M2M5 clusters /. A partir de 2025 de janeiro, esses endpoints gerenciam clusters Flex. Você pode continuar usando esses endpoints de API sem alterações até que eles atinjam o fim da vida útil (EOL) em 2026 de janeiro.

A partir de de 2025 janeiro, os endpoints da API para instâncias sem servidor gerenciarão os clusters flexíveis. A partir de de 2025 março, todas as instâncias sem servidor existentes foram migradas para clusters gratuitos, clusters flexíveis ou clusters dedicados, de acordo com seu uso. Se sua instância sem servidor for migrada para um cluster gratuito ou cluster dedicado, você deverá usar o endpoint da API de Cluster. Para ver para quais níveis o Atlas migrará suas instâncias, consulte a página Todos os clusters na UI do Atlas .

Se você tentar criar um cluster M2 do M5 ou utilizando o endpoint creategroupcluster ou uma instância sem servidor utilizando o endpoint creategroupserverlessinstance, entre janeiro de 2025 e janeiro 2026 de, você criará um cluster Flex. O suporte para esses endpoints termina em janeiro 2026 de 20}.

Você deve substituir as chamadas para endpoints da API de instâncias sem servidor por chamadas configuradas adequadamente para os endpoints da API de Clusters antes que suas instâncias sem servidor sejam migradas para os clusters Flex.

As seguintes alterações também se aplicam aos endpoints API listados a partir de janeiro de 2025.

Endpoint	Impacto
listgroupprivateendpointserverlessinstanceendpoint	Descontinuado para novos clusters flexíveis. Retorna um erro porque as instâncias sem servidor são migradas para clusters gratuitos, flexíveis ou dedicados a partir de 2025 de maio.
upgradegroupclustertenantupgrade	Quando usado em clusters Flex, `upgradeSharedCluster` usa o valor definido pelo usuário, mas não alterna o Backup contínuo porque o backup contínuo não está disponível para clusters Flex.
creategroupserverlessinstance	Quando usado em clusters Flex, `createServerlessInstance` usa o valor definido pelo usuário, mas não alterna o Backup contínuo porque o backup contínuo não está disponível para clusters Flex.
updategroupserverlessinstance	Quando usado em clusters Flex, `updateServerlessInstance` usa o valor definido pelo usuário, mas não alterna o Backup contínuo porque o backup contínuo não está disponível para clusters Flex.
setgroupserverlessperformanceadvisorautoindexing	Quando usado em clusters Flex, `setServerlessAutoIndexing` assume o valor definido pelo usuário, mas não alterna a indexação automática porque a indexação automática não está disponível para clusters Flex.
getgroupserverlessperformanceadvisorautoindexing	Quando usado em clusters Flex, `getServerlessAutoIndexing` assume o valor definido pelo usuário, mas não alterna a indexação automática porque a indexação automática não está disponível para clusters Flex.

Migração do Provedor Terraform Atlas

O HashiCorp Terraform Provider oferece suporte a clusters Flex. O suporte geral do Terraform para clusters M2/M5 e instâncias sem servidor continuará até janeiro de 2026.

Você deve atualizar suas configurações do Terraform para operar em clusters Flex de acordo com as seguintes linhas do tempo, dependendo de quais recursos você usa:

funcionalidade	Prazo de atualização
Link de interface de endpoint privado	De abril de 2025
Serviço de endpoints do PrivateLink sem servidor para novas instâncias sem servidor	Janeiro, 2025
Serviço de endpoints do PrivateLink sem servidor para instâncias sem servidor existentes	maio, 2025
Todas as outras funcionalidades	Janeiro, 2026

Migração do SDK Go

O Atlas Go SDK suporta clusters Flex a partir de novembro de 2024. O suporte geral do SDK para M2M5 clusters / e instâncias sem servidor continua até 16 de 2026 janeiro. Você deve atualizar seus scripts do SDK para operar em clusters Flex de acordo com os seguintes cronogramas, dependendo de quais recursos você usa:

funcionalidade	Prazo de atualização
A API ServerlessPrivateEndpointsApi	maio, 2025
Todas as outras funcionalidades	Janeiro, 2026

Migração do Atlas CLI

O Atlas CLI permite clusters flexíveis a partir de 2024 de dezembro. Para saber mais, consulte a referência de comando e selecione a versão mais recente do Atlas CLI no menu suspenso.

O suporte para backup contínuo na nuvem em instâncias sem servidor foi encerrado em 2025 de janeiro. Se você usou backup em nuvem contínuo em qualquer uma de suas instâncias sem servidor, deverá atualizar seus fluxos de trabalho do Atlas CLI para remover o backup em nuvem contínuo de instância sem servidor para evitar erros.

A compatibilidade geral do Atlas CLI para clusters M2/M5 e instâncias sem servidor continua até 2026 de janeiro. Antes de 2026 de janeiro, você deve remover todos os comandos M2/M5 e Instância sem Servidor dos fluxos de trabalho do Atlas CLI .

Migração do Atlas Kubernetes Operator

O Atlas Kubernetes Operator suporta clusters Flex a partir de 2025 de fevereiro.

Até 2026 de janeiro, para preservar a compatibilidade com versões anteriores por um período de tempo, o Atlas permite a você gerenciar clusters migrados por meio das APIs de instâncias sem servidor e de clusters flexíveis, inclusive quando você está usando o Atlas Kubernetes Operator.
Você pode criar e gerenciar clusters Flex nos mesmos recursos personalizados do AtlasDeployment nos quais você criou e gerenciou instâncias sem servidor e clusters do M2 e M5. Para saber mais, consulte o recurso personalizado AtlasDeployment na documentação do Atlas Kubernetes Operator.
Você não pode criar novos clusters M2/M5 e instâncias sem servidor no Atlas. Tentar fazer isso cria um cluster Flex .
Substitua as referências a spec.serverlessSpec no AtlasDeployment Recurso Personalizado pela configuração de spec.flexSpec.
Substitua as referências a spec.deploymentSpec no AtlasDeployment Recurso Personalizado pela configuração de spec.flexSpec.
Se você receber erros durante as reconciliações relacionadas a endpoints privados, deverá atualizar para pelo menos o Atlas Kubernetes Operator 2.7.1 ou posterior, ou substituir a configuração serverlessSpec pela configuração de flexSpec no recurso personalizado AtlasDeployment.
Para evitar erros de reconciliação que você pode notar após a migração automática,
faça as seguintes alterações nas configurações do seu CRD:
- Remova a configuração spec.deploymentSpec.replicationSpecs.zoneName.
- Remova qualquer uma das configurações do spec.deploymentSpec.replicationSpecs.regionConfigs após o primeiro conjunto de configurações.
- Especifique replicaset somente no spec.deploymentSpec.clusterType.
Como alternativa, substitua as referências a spec.deploymentSpec no AtlasDeployment Recurso personalizado pela configuração de spec.flexSpec.
Até janeiro de 2026, você deve remover todas as configurações restantes do M2/M5 e Instância sem servidor dos seus recursos personalizados do Atlas Kubernetes Operator , pois a compatibilidade com versões anteriores das APIs termina em janeiro de 2026. Nesse momento, as APIs antigas serão removidas e apenas as APIs relacionadas a clusters Flex permanecerão em vigor. As versões do Atlas Kubernetes Operator após 2.7.1 não suportam instâncias sem servidor existentes.

Migração do Atlas CloudFormation

O Atlas CloudFormation e o Cloud Development Kit (CDK) agora oferecem suporte a clusters Flex. O suporte geral para M2M5 clusters / continua até janeiro 2026 de .

O suporte para endpoints privados sem servidor e o parâmetro Properties.ContinuousBackupEnabled do recurso de instância sem servidor foram encerrados quando o Atlas CloudFormation introduziu o suporte ao cluster Flex. Esses recursos não estão mais disponíveis no CloudFormation ou CDK. Atualize suas configurações para removê-las. Você deve remover todos os recursos de instância M2/M5 e sem servidor dos seus recursos do Atlas CloudFormation e CDK antes de janeiro de 2026.

Importante

Use o recurso MongoDB::Atlas::Cluster no CloudFormation ou o recurso CfnCluster no CDK em vez do recurso MongoDB::Atlas::FlexCluster no CloudFormation ou o recurso CfnFlexCluster no CDK para criar e gerenciar clusters Flex. MongoDB::Atlas::Cluster e CfnCluster suportam clusters Flex, e atualizações futuras estarão disponíveis somente por meio desses recursos. O CloudFormation e o CDK ainda não oferecem suporte à migração entre clusters Flex e outros tipos de cluster, mas o suporte será adicionado no futuro.

Para mais informações, veja:

Voltar

APIs GraphQL no Amazon Web Services