Migre suas ferramentas programáticas de M2, M5 ou Instâncias sem servidor para Flex Clusters

Nesta página

Migrando configuração da API

Migração do Provedor Terraform Atlas
Migração do SDK Go
Migração do Atlas CLI
Migração do Atlas Kubernetes Operator
Migração do Atlas CloudFormation

Importante

A partir de fevereiro 2025, você pode criar clusters Flex, e não pode mais criar clusters M2 e M5 ou instâncias sem servidor na UI do Atlas, Atlas CLI, API de Administração do Atlas, Atlas Kubernetes Operator, HashiCorp Terraform, ou Recursos do Atlas CloudFormation. Você ainda pode usar clusters M2 e M5 existentes e instâncias sem servidor.

O Atlas descontinuou os clusters M2 e M5 e as instâncias sem servidor. O Atlas migrará automaticamente todos os clusters M2 e M5 existentes para clusters Flex. Para instâncias sem servidor, o Atlas decidirá se as instâncias devem ser migradas para clusters gratuitos, clusters Flex ou clusters dedicados conforme o seu uso. Para ver para quais níveis o Atlas migrará suas instâncias, consulte a página Todos os Clusters na IU do Atlas.

Depois que a ferramenta de sua escolha oferecer suporte a clusters Flex, atualize seu código substituindo todas as referências a tipos de instância obsoletos por referências a clusters Flex.

Observação

Se suas cargas de trabalho exigirem endpoints privados ou backup contínuo e restauração point-in-time, recomendamos que você mude para clusters dedicados do Atlas .

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. Após 2025 de março, todas as instâncias sem servidor existentes serão migradas para clusters gratuitos, clusters flexíveis ou clusters dedicados, de acordo com o 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 createCluster ou uma instância sem servidor utilizando o endpoint createServerlessInstance, 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
listServerlessPrivateEndpoints	Descontinuado para novos clusters flexíveis. Retornará um erro quando as instâncias sem servidor forem migradas para clusters gratuitos, flexíveis ou dedicados após 2025 de março.
upgradeSharedCluster	Quando usado em clusters Flex, o `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.
createServerlessInstance	Quando usado em clusters Flex, o `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.
updateServerlessInstance	Quando usado em clusters Flex, o `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.
setServerlessAutoIndexing	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.
getServerlessAutoIndexing	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 suporta 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	Março, 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	Março, 2025
Todas as outras funcionalidades	Janeiro, 2026

Migração do SDK Go

O Atlas Go SDK suportará clusters Flex a partir de novembro 2024 de. O suporte geral do SDK para M2M5 clusters / e instâncias sem servidor continuará até janeiro 2026 de 2012. 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	Março, 2025
Todas as outras funcionalidades	Janeiro, 2026

Migração do Atlas CLI

O Atlas CLI suportará clusters Flex a partir de dezembro de 2024. O suporte geral do Atlas CLI para clusters M2/M5 e instâncias sem servidor continuará até 2026 de janeiro. O suporte para backup contínuo na nuvem em instâncias sem servidor foi encerrado em 2025 de janeiro. Você deve atualizar seus fluxos de trabalho do Atlas CLI para remover o backup em nuvem contínuo da Serverless Instance antes de janeiro de 2025; você deve remover todos os comandos do M2/M5 e Instância sem servidor dos fluxos de trabalho do Atlas CLI antes de janeiro de 2026.

Migração do Atlas Kubernetes Operator

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

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 AtlasDeployment recursos personalizados do nos quais você criou e gerenciou instâncias sem servidor M2 e M5 clusters do e. Para saber mais, consulte o recurso personalizado AtlasDeployment na documentação do Atlas Kubernetes Operator .
Você não pode criar novos M2M5 clusters / e instâncias sem servidor no Atlas. Tentar fazer isso cria um cluster Flex .
Você ainda pode utilizar instâncias sem servidor existentes no Atlas Kubernetes Operator mesmo que as instâncias sem servidor existentes sejam preteridas a partir do início de fevereiro de 2025.
Para suas instâncias sem servidor existentes, você pode optar por substituir as referências a spec.serverlessSpec no AtlasDeployment Recurso personalizado pela configuração de spec.flexSpec. Ou você pode continuar usando a mesma especificação. O gerenciamento de uma implantação por meio do spec.serverlessSpec no AtlasDeployment Recurso personalizado continuará a funcionar mesmo depois que o Atlas migrar automaticamente esses clusters existentes para clusters do Flex em março de 2025.
Para seus clusters M2 e M5 existentes, você pode optar por substituir as referências a spec.deploymentSpec no AtlasDeployment Recurso Personalizado pela configuração de spec.flexSpec. Ou você pode continuar usando a mesma especificação. O gerenciamento de uma implantação por meio do spec.deploymentSpec no AtlasDeployment Recurso Personalizado continuará funcionando mesmo depois que o Atlas migrar automaticamente esses clusters M2 e M5 existentes para clusters Flex em maio de 2025.
Para suas instâncias sem servidor existentes, se você receber erros durante as reconciliações relacionadas a endpoints privados, deverá atualizar para o Atlas Kubernetes Operator 2.7.1 ou substituir a configuração serverlessSpec pela configuração de flexSpec no recurso personalizado AtlasDeployment.
Para seus clusters do M2 e M5, para evitar erros de reconciliação que você pode notar após a migração automática, faça as seguintes alterações em suas configurações de 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é 2026 de janeiro, você deve remover todas as configurações restantes de M2/M5 e Instância sem servidor dos recursos personalizados do Atlas Kubernetes Operator , pois a compatibilidade com versões anteriores das APIs termina em 2026 de janeiro, quando as APIs antigas serão removidas e somente as APIs relacionados aos clusters Flex permanecerão em vigor.
As versões mais recentes do Atlas Kubernetes Operator deixarão de oferecer suporte aos clusters M2/M5 existentes e às instâncias sem servidor. As versões mais antigas do Atlas Kubernetes Operator continuarão a oferecer suporte a esses tipos de instância até janeiro de 2026.

Migração do Atlas CloudFormation

Atlas CFN e CDK suportarão clusters Flex a partir da primeira metade de 2025. O suporte geral para clusters M2/M5 continuará até 2026 de janeiro.

O suporte para Endpoints Privados sem Servidor e o Properties.ContinuousBackupEnabled parâmetro do recurso de Instância sem Servidor terminarão quando o Atlas CFN introduzir suporte de cluster Flex. Você deve atualizar seus recursos CFN e CDK para remover esses recursos até março de 2025. Você deve remover todos os recursos de instância M2/M5 e sem servidor dos seus recursos Atlas CFN e CDK antes de janeiro de 2026.

Voltar

Exemplo verificado do Terraform HashiCorp

Atlas CLI