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