Atlas クラスターのメジャーバージョンは、クラスターを変更することでいつでもアップグレードできます。
新しい MongoDB バージョンへの移行をスムーズにし、アプリケーションに影響を与えないようにするには、本番環境の Atlas クラスターのメジャー バージョンをアップグレードする前に、次の手順でステージング クラスターを作成し、新しい MongoDB バージョンに対してアプリケーションをテストします。
Considerations
次の考慮事項が適用されます。
アップグレードの前に、クラスターが正常な状態になっている必要があります。
メジャーバージョンアップグレードの前にオンデマンドスナップショットを取得する場合は、スナップショットが完了するまで待ってからアップグレードします。
クラスターを下位バージョンからMongoDB 8.0 にアップグレードする場合は、Atlas の 書込みブロック動作 に注意してください。MongoDB 8.0 にアップグレードしてすぐに専用クラスターのプライマリノードへの書き込みがブロックされないようにするには、次の手順を実行します。
アップグレード後にワークロードを処理するのに十分なストレージキャパシティーがクラスターにあることを確認します。
ストレージのオートスケーリング を有効にすることで、ディスク使用率が 90% を超えるとクラスターストレージが自動的にスケーリングされ、一貫したワークロードの可用性とパフォーマンスが確保されます。
各メジャー バージョンには、以前のバージョンとの下位互換性がない可能性がある機能がいくつか含まれています。新しいメジャー バージョンにアップグレードする場合は、アプリケーションに影響する可能性のある変更について、リリースノートを確認してください。
あるいは、 Stable APIを使用すると、 MongoDBバージョン間の動作の変更によってアップグレード後にアプリケーションが中断されないことが保証されます。
MongoDB Stable API には、アプリケーションがデータの読み取りと書き込み、コレクションとインデックスの作成、その他の一般的なタスクの実行に使用するMongoDBコマンドのサブセットが含まれています。Stable API:
アプリケーションを実行するMongoDB APIのバージョンを指定でき、アプリケーションのAPI の長期的な安定性を確保できます。
より頻繁なリリースとサーバーの自動アップグレードをサポートしているため、アプリケーションは下位互換性のない変更のリスクを負うことなく、急速にリリースされる機能を利用できます。
制限
クラスターのバージョンをアップグレードする場合、次の制限が適用されます。
固定された 機能の互換性バージョンより2バージョン上のバージョンにアップグレードすることはできません。クラスターが機能の互換性バージョン 6.0 に固定されている場合、7.0 にのみアップグレードでき、8.0 以降にはアップグレードできません。クラスターに機能の互換性バージョン（FCV）をピン留めする方法を学ぶには、 クラスターに機能の互換性バージョン（FCV）をピン留めする方法をご覧ください。
Atlas クラスターは一度に 1 段階のメジャー バージョンにのみアップグレードできます。クラスターをアップグレードするときにメジャー バージョンをスキップすることはできません。
MongoDB のメジャーバージョンをアップグレードすると、アップグレード前にクラスターの FCV（機能の互換性バージョン）を固定していない限り、以前のバージョンにダウングレードすることはできません。
ライブ移行では、ソースおよびデスティネーション クラスターの機能の互換性バージョンがメジャーバージョンで一致している必要があります。サポートされている移行パスの詳細については、「データの移行またはインポート」を参照してください。
重要
ライブ移行を使用する場合は、専有クラスターに Latest Version With Auto Upgrades を選択しないでください。このオプションは、クラスターを最新のマイナー リリースに自動的にアップグレードします。ライブ移行はメジャーリリースのみをサポートしており、MongoDBバージョン 8.2 などのマイナーリリースはサポートしていません。
MongoDB 6.0以降、
$$SEARCH_META集計変数は$searchMetaステージ以降のどのステージでも使用できません。以前のバージョンからMongoDB 6.0 にアップグレードし、 MongoDB Search
$searchMetaクエリで$$SEARCH_META集計変数を使用する場合は、エラーを回避するために、クラスターをアップグレードする前に確認してください。
必要なアクセス権
クラスターをアップグレードするには、プロジェクトの Project Owner 以上のロールが必要です。
MongoDB のメジャー バージョンをアップグレードする
MongoDBのメジャー バージョンをアップグレードする方法：
AtlasClusters で、プロジェクトの ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、 Database見出しの下のClustersをクリックします。
[ Clusters （クラスター） ] ページが表示されます。
ステージング環境用の Atlas クラスターを作成します。
注意
すでにステージング環境として Atlas クラスターを使用している場合は、この手順を省略できます。
[Create] ボタンをクリックして、クラスター作成モーダルを開きます。ステージング クラスターを本番クラスターと一致するように構成します。ステージング クラスターのバックアップを有効にする必要はありません。
新しいクラスターを作成する方法については、「クラスターの作成」を参照してください。
重要
ステージング クラスターとして小規模なクラスター階層を選択する場合は、そこで実行するパフォーマンステストに、アップグレード後の本番クラスターのパフォーマンスが反映されない可能性があることを考慮してください。ステージング クラスターにミラーリングするデータ量によっては、より大きなストレージサイズを選択する必要があるかもしれません。
ステージング クラスターを本番クラスターのデータで更新します。
注意
すでにステージング環境として最新の Atlas クラスターを使用している場合は、この手順を省略できます。
本番稼働用クラスターでバックアップを有効にしている場合は、 最新のスナップショットを復元 し、ステージングクラスターを送信先として選択します。
ステージング アプリケーションをステージング クラスターに差し向けます。
ステージング用アプリケーションをアップデートし、ステージング クラスターに点。ステージングクラスターのMongoDBドライバー対応接続文字列を取得する方法については、「 クライアント ライブラリ経由でクラスターに接続する 」を参照してください。
アプリケーションがステージングクラスターに正常に接続でき、かつ、アプリケーションが期待どおりに動作することを確認します。
（オプション）アプリケーションを最新の MongoDB ドライバーにアップグレードします。
アプリケーションをクラスターのMongoDBバージョンに対応した最新のMongoDBドライバーにアップグレードすると、新しいバージョンのMongoDBが提供する機能をフルに利用できるようになります。また新しいドライバー バージョンを使用すると、パフォーマンスや安定性が向上する場合もあります。特定のMongoDBバージョンに推奨されるMongoDBドライバーと接続例に関するドキュメントについては、「 クライアント ライブラリ経由でクラスターに接続する 」を参照してください。 Stable APIを使用すると、 MongoDBバージョン間の動作の変更によってアプリケーションが中断されることがなくなります。
アプリケーションをアップグレードした後にバグが発生した場合は、 利用中の MongoDB ドライバーの JIRA プロジェクトでチケットを申請してください。
AtlasClusters で、プロジェクトの ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、 Database見出しの下のClustersをクリックします。
[ Clusters （クラスター） ] ページが表示されます。
ステージング クラスターを新しいメジャー MongoDB バージョンにアップデートします。
[Edit Config] をクリックし、ドロップダウン メニューからステージング クラスターを選択します。
クラスターのバージョンを、必要なメジャー MongoDB バージョンに変更します。
重要
アップグレードする前にクラスターの FCV が以前に固定されていた場合を除き、Atlas クラスターのMongoDBバージョンをダウングレードすることはできません。ステージング環境を元のMongoDBバージョンで再デプロイする場合は、クラスターを終了して再作成する必要があります。
Confirm & Deploy をクリックして、変更を配置します。
Atlas で自動的にクラスターのアップグレードが開始されます。Atlas でのクラスターのアップグレードに必要な時間を測定し、本番クラスターのアップグレードについて全体的な予想を立てることを検討します。
アップグレードされたステージング クラスターでバージョン固有の問題が発生した場合は、サポート チケットを申請してください。
アップグレードされたステージング クラスターに対してアプリケーションをテストします。
ステージング クラスターで必要なパフォーマンスおよび操作テストを実行します。
アップグレードされたステージング クラスターでバージョン固有の問題が発生した場合は、サポート チケットを申請してください。
重要
メジャーバージョンアップグレードには、少なくとも 1 回のレプリカセットの選挙が必要です。ステージングクラスターは、プライマリフェイルオーバーに対するアプリケーションの回復力をテストする機会として利用します。詳細なドキュメントについては、「プライマリフェイルオーバーのテスト」を参照してください。
本番クラスターをターゲットの MongoDB バージョンにアップグレードします。
ステージングクラスターのパフォーマンスと操作に問題がなければ、本番クラスターでこれまでの アップグレード 手順を繰り返します。
本番アプリケーションを新しいMongoDBドライバーにアップグレードし、正常に動作することをテストします。この手順により、データベースのアップグレード前に、アプリケーションが新しいMongoDBバージョンと互換性があることを確認できます。
アプリケーションを準備 したら、本番クラスターのMongoDBバージョンをアップグレードします。Atlas によるアップグレードが完了したら、アプリケーションが正常に接続され、動作することを確認します。
アップグレードした本番クラスターで問題が発生した場合は、次のセクションの手順に従って高優先順位のサポートチケットを申請してください。
アップグレード中の機能の互換性 (FCV) の管理
MongoDB のメジャー バージョン アップグレードは、Atlas とオンプレミスの配置の両方でサポートされています。 FCV は、 MongoDBの以前のバージョンと互換性のないデータを保持する機能を有効または無効にします。Atlas でアップグレードする前にクラスターの FCV を固定することができるため、バージョンの互換性の問題が発生することなく、アップグレード後にMongoDB を以前のバージョンに戻すことができます。
警告
FCV は、固定日から最大 週間のみ保持される短期間の測定値であり、以前のバイナリ4 バージョンの動作をシミュレートすることはありません。新しいサーバー機能を可能にする特定の内部データ構造のアップグレードのみが延期されます。 以前のバージョンへのダウングレードが不要であることが確認できたら、現在のバイナリ バージョンと一致するように FCV の固定を解除します。
クラスターのFCV（機能の互換性バージョン）をピン留めまたは解除する方法や、クラスターをメジャーバージョンごとにダウングレードする方法の詳細については、「クラスターの MongoDB メジャーバージョンをダウングレードする」をご覧ください。
サポートお問い合わせ
このドキュメントで説明されている範囲外で移行のサポートに関して質問がある場合、または移行中にエラーが発生した場合は、Atlas のユーザーインターフェイスからサポートチケットを申請してください。