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