Docs Menu
Docs Home
/
MongoDB Atlas
/ /

M2、M5、またはサーバーレスインスタンスからプログラム ツールを Flex クラスターに移行する

項目一覧

  • API構成の移行
  • Terraform Atlas プロバイダーの移行
  • Go SDK の移行
  • Atlas CLI の移行
  • Atlas Kubernetes演算子の移行
  • Atlas CloudFormation の移行

重要

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エンドポイントは、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 クラスターで使用する場合、upgradeSharedCluster はユーザーが設定した値を受け取りますが、Flex クラスターでは継続的なバックアップが利用できないため、継続的なバックアップを切り替えません。

Flex クラスターで使用する場合、createServerlessInstance はユーザーが設定した値を受け取りますが、Flex クラスターでは継続的なバックアップが利用できないため、継続的なバックアップを切り替えません。

Flex クラスターで使用する場合、updateServerlessInstance はユーザーが設定した値を受け取りますが、Flex クラスターでは継続的なバックアップが利用できないため、継続的なバックアップを切り替えません。

Flex クラスターで使用する場合、setServerlessAutoIndexing はユーザーが設定した値を受け取りますが、Flex クラスターでは自動インデックス作成が利用できないため、自動インデックス作成は切り替えられません。

Flex クラスターで使用する場合、getServerlessAutoIndexing はユーザーが設定した値を受け取りますが、Flex クラスターでは自動インデックス作成が利用できないため、自動インデックス作成は切り替えられません。

HashiCorp Terraform プロバイダー は Flex クラスターをサポートします。M2/M5 クラスターとサーバーレスインスタンスの一般的な Terraform サポートは、2026 年 1 月まで継続されます。

使用する機能に応じて、次のタイムラインに従って Flex クラスターで動作する Terraform 構成を更新する必要があります。

Atlas Go SDK は、 の 11 月から Flex クラスターをサポートします。2024M2/M5 クラスターとサーバーレスインスタンスの一般 SDK サポートは 1 月 2026 まで継続されます。使用する機能に応じて、次のタイムラインに従って Flex クラスターで動作する SDK スクリプトを更新する必要があります。

機能
更新期限

2025 年 5 月

その他のすべての機能

2026 年 1 月

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演算子は、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.deploymentSpec AtlasDeploymentM2M5クラスターを 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 CFN と CDK は、2025 の最初の半分から Flex クラスターをサポートします。 M2/M5 クラスターの一般サポートは 1 月 2026 まで継続されます。

サーバーレス プライベートエンドポイント および サーバーレス インスタンスリソースの Properties.ContinuousBackupEnabled パラメーターのサポートは、Atlas CN が Flex クラスターのサポートを導入するときに終了します。これらのリソースは 4 月 2025 までに削除するように、CN と CDK リソースを更新する必要があります。M2M5年 1 月 日より前に、Atlas CN と CDK リソースからすべての /2026 とサーバーレスインスタンスの機能を削除する必要があります。

戻る

検証済み HashiCorp テラフォームの例