M2、M5、またはサーバーレスインスタンスからプログラム ツールを Flex クラスターに移行する
項目一覧
重要
2025 日 2 月現在、Flex クラスターは作成可能ですが、Atlas UI、Atlas CLI、Atlas Administration API、Atlas Kubernetes Operator、HashiCorp Terraform、または Atlas CloudFormation Resources で M2 および M5 クラスターやサーバーレスインスタンスを作成することはできなくなります。既存の M2 および M5 クラスターとサーバーレスインスタンスは引き続きご利用いただけます。
Atlas は M2 および M5 クラスターとサーバーレスインスタンスを非推奨にしました。2025年4月2以降、Atlasは既存のすべてのM2およびM5クラスターをFlexクラスターに自動的に移行します。
サーバーレスインスタンスの場合、5月5日2025以降、Atlasは使用状況に応じて、インスタンスを無料クラスター、Flexクラスター、または専有クラスターに移行するかどうかを決定します。Atlas がインスタンスをどの階層に移行するかを確認するには、Atlas UI のすべてのクラスターページを参照してください。
選択したツールが Flex クラスターをサポートしたら、非推奨のインスタンスタイプへのすべての参照を Flex クラスターへの参照に置き換えて、コードを更新します。
注意
ワークロードに プライベートエンドポイント または 継続的なバックアップとポイントインタイム復元 が必要な場合は、Atlas 専用クラスターに変換することをお勧めします。
API構成の移行
このセクションの表にリストされているクラスターAPIエンドポイントは、M2 /M5 クラスターと互換性があります。1 月 2025 現在、これらのエンドポイントは Flex クラスターを管理しています。 これらのAPIエンドポイントは、2026 年 1 月にサポート終了（EOL）に達するまで、変更せずに使用し続けることができます。
2025 年 1 月 日現在、サーバーレスインスタンスのAPIエンドポイントは Flex クラスターを管理します。2025後、既存のすべてのサーバーレスインスタンスは、使用量に応じて 無料クラスター、 Flex クラスター、または専有クラスターに移行されます。サーバーレスインスタンスが無料クラスターまたは専有クラスターに移行される場合は、代わりにクラスターAPIエンドポイントを使用する必要があります。Atlas が インスタンスをどの階層に移行するかを確認するには、Atlas UIの [ すべてのクラスター ] ページを参照してください。
M2M5の 1 月から2025 の 1 月の間に、createCluster エンドポイントを使用して または クラスター、または createServerlessInstance2026 エンドポイントを使用してサーバーレスインスタンスを作成しようとすると、代わりに Flex クラスターが作成されます。これらのエンドポイントのサポートは 1 月 2026 を終了します。
サーバーレスインスタンスが Flex クラスターに移行される前に、サーバーレスインスタンスAPIエンドポイントへの呼び出しを、クラスターAPIエンドポイントへの適切に構成された呼び出しに置き換える必要があります。
次の変更は、2025 の 1 月以降、リスト内のAPIエンドポイントにも適用されます。
エンドポイント | 影響 |
|---|---|
新しい Flex クラスターでは非推奨。サーバーレス インスタンスが 5 月 60 日以降に無料クラスター、Flex2025 クラスター、または専有クラスターに移行されると、エラーが返されます。 | |
Flex クラスターで使用する場合、 | |
Flex クラスターで使用する場合、 | |
Flex クラスターで使用する場合、 | |
Flex クラスターで使用する場合、 | |
Flex クラスターで使用する場合、 |
Terraform Atlas プロバイダーの移行
HashiCorp Terraform プロバイダー は Flex クラスターをサポートします。M2/M5 クラスターとサーバーレスインスタンスの一般的な Terraform サポートは、2026 年 1 月まで継続されます。
使用する機能に応じて、次のタイムラインに従って Flex クラスターで動作する Terraform 構成を更新する必要があります。
機能 | 更新期限 |
|---|---|
年 4 月 2025日 | |
2025 年 1 月 | |
2025 年 5 月 | |
その他のすべての機能 | 2026 年 1 月 |
Go SDK の移行
Atlas Go SDK は、 の 11 月から Flex クラスターをサポートします。2024M2/M5 クラスターとサーバーレスインスタンスの一般 SDK サポートは 1 月 2026 まで継続されます。使用する機能に応じて、次のタイムラインに従って Flex クラスターで動作する SDK スクリプトを更新する必要があります。
機能 | 更新期限 |
|---|---|
2025 年 5 月 | |
その他のすべての機能 | 2026 年 1 月 |
Atlas CLI の移行
Atlas CLI は、12 月 2024 以降の Flex クラスターをサポートしています。詳細については、 コマンド参照を参照し、 ドロップダウンから最新の Atlas CLI バージョンを選択します。
サーバーレスインスタンスでの継続的なクラウドバックアップのサポートは 1 月 2025 日で終了しました。サーバーレスインスタンスのいずれかで継続的なクラウドバックアップを使用していた場合は、エラーを回避するために Atlas CLI ワークフローを更新して サーバーレスインスタンスのクラウドバックアップを削除する 必要があります。
M2/M5 クラスターとサーバーレスインスタンスの一般的な Atlas CLI サポートは、1 月 2026 まで継続されます。2026 より前に、Atlas CLI ワークフローからすべての M2/M5 と Serverless Instance コマンドを削除する必要があります。
Atlas Kubernetes演算子の移行
Atlas Kubernetes演算子は、2 月 2025 以降の Flex クラスターをサポートしています。
2026 まで下位互換性を一定期間維持するため、Atlas では Atlas Kubernetes Operator を使用している場合を含め、サーバーレスインスタンスと Flex クラスター API の両方で移行されたクラスターを管理できます。
Flex クラスターは、サーバーレス インスタンスと
M2およびM5クラスターを作成および管理した同じAtlasDeploymentカスタム リソース内で作成および管理できます。詳細については、Atlas Kubernetes Operator ドキュメントの AtlasDeployment カスタムリソースを参照してください。Atlas では新しい
M2/M5クラスターとサーバーレスインスタンスを作成できません。そのような操作を試みると、代わりに Flex クラスターが作成されます。既存のサーバーレス インスタンスは 2 月 2025 日ドキュメントで非推奨になっていますが、Atlas Kubernetes Operator では既存のサーバーレスインスタンスを引き続き使用できます。
既存のサーバーレスインスタンスでは、
AtlasDeploymentカスタム リソース内のspec.serverlessSpecへの参照をspec.flexSpecの構成に置き換えることを選択できます。または、同じ仕様を引き続き使用することもできます。spec.serverlessSpecAtlasDeploymentカスタム リソースの 経由で配置を管理する方法は、Atlas が 5 月 にこれらの既存のクラスタを Flex2025 クラスターに自動的に移行した後でも、引き続き機能します。既存の
M2クラスターとM5クラスターでは、AtlasDeploymentカスタム リソース内のspec.deploymentSpecへの参照をspec.flexSpecの構成に置き換えることを選択できます。または、同じ仕様を引き続き使用することもできます。カスタム リソースの 経由で配置を管理することは、Atlas がこれらの既存の クラスターとspec.deploymentSpecAtlasDeploymentM2M5クラスターを 4 月に Flex2025 クラスターに自動的に移行した後でも、引き続き機能します。既存のサーバーレスインスタンスで、調整中にプライベートエンドポイントに関連するエラーが発生した場合は、Atlas Kubernetes Operator 2.7.1 にアップグレードするか、
AtlasDeploymentカスタムリソースでserverlessSpec構成をflexSpecの構成に置き換える必要があります。M2クラスターとM5クラスターで、自動移行後に発生する可能性のある調整エラーを回避するには、CRD 構成を次の変更してください。spec.deploymentSpec.replicationSpecs.zoneName設定を削除します。最初の 設定セットの後、
spec.deploymentSpec.replicationSpecs.regionConfigs設定のいずれかを削除します。spec.deploymentSpec.clusterTypeでのみreplicasetを指定する。
または、
AtlasDeploymentカスタム リソース内のspec.deploymentSpecへの参照をspec.flexSpecの構成に置き換えます。年 1 月2026 日までに、残りのすべての
M2/M5およびサーバーレスインスタンスの構成を Atlas Kubernetes Operator カスタム2026 リソースから削除する必要があります。これは、古い API が削除され、 API のみが API の下位互換性を終了するためです。 Flex クラスターに関連するものはその場で維持されます。Atlas Kubernetes Operator の新しいリリースでは、既存の
M2/M5クラスターとサーバーレスインスタンスのサポートが終了します。Atlas Kubernetes Operator の古いバージョンでは、2026 年 1 月までこれらのインスタンスタイプを引き続きサポートします。
Atlas CloudFormation の移行
Atlas CFN と CDK は、2025 の最初の半分から Flex クラスターをサポートします。 M2/M5 クラスターの一般サポートは 1 月 2026 まで継続されます。
サーバーレス プライベートエンドポイント および サーバーレス インスタンスリソースの Properties.ContinuousBackupEnabled パラメーターのサポートは、Atlas CN が Flex クラスターのサポートを導入するときに終了します。これらのリソースは 4 月 2025 までに削除するように、CN と CDK リソースを更新する必要があります。M2M5年 1 月 日より前に、Atlas CN と CDK リソースからすべての /2026 とサーバーレスインスタンスの機能を削除する必要があります。