クラスターのメジャー MongoDB バージョンをアップグレードする
項目一覧
Atlas クラスターのメジャーバージョンは、クラスターを変更することでいつでもアップグレードできます。
新しい MongoDB バージョンへの移行をスムーズにし、アプリケーションに影響を与えないようにするには、本番環境の Atlas クラスターのメジャー バージョンをアップグレードする前に、次の手順でステージング クラスターを作成し、新しい MongoDB バージョンに対してアプリケーションをテストします。
Considerations
次の考慮事項が適用されます。
アップグレードの前に、クラスターが正常な状態になっている必要があります。
メジャーバージョンアップグレードの前にオンデマンドスナップショットを取得する場合は、スナップショットが完了するまで待ってからアップグレードします。
Atlas クラスターは一度に 1 段階のメジャー バージョンにのみアップグレードできます。クラスターをアップグレードするときにメジャー バージョンをスキップすることはできません。
各メジャー バージョンには、以前のバージョンとの下位互換性がない可能性がある機能がいくつか含まれています。新しいメジャー バージョンにアップグレードする場合は、アプリケーションに影響する可能性のある変更について、リリースノートを確認してください。あるいは、Stable API を使用すると、MongoDB バージョン間の動作の変更によってアップグレード後にアプリケーションが中断されることがなくなります。
MongoDB Stable API には、アプリケーションがデータの読み取りと書き込み、コレクションとインデックスの作成、その他の一般的なタスクの実行に使用する MongoDB コマンドのサブセットが含まれています。Stable API を使用すると、アプリケーションを実行する MongoDB API のバージョンを指定でき、アプリケーションの API の長期的な安定性を確保できます。より頻繁なリリースとサーバーの自動アップグレードをサポートしているため、アプリケーションは下位互換性のない変更のリスクを負うことなく、急速にリリースされる機能を利用できます。
MongoDBのメジャー バージョンをアップグレードした後は、アップグレードする前にクラスターのFCVを固定しない限り、以前のバージョンにダウングレードすることはできません。
ライブ移行では、ソースクラスターと宛先クラスターの FCV がほとんどの場合一致する必要があります。詳細については、「 データの移行またはインポート 」を参照してください。
MongoDB 6.0以降、
$$SEARCH_META集計変数は$searchMetaステージ以降のどのステージでも使用できません。以前のバージョンから MongoDB 6.0 にアップグレードし、Atlas Search
$searchMetaクエリで$$SEARCH_META集計変数を使用する場合は、エラーを回避するため、クラスターをアップグレードする前に検討してください。
必要なアクセス権
クラスターをアップグレードするには、プロジェクトの Project Owner 以上のロールが必要です。
MongoDBのメジャー バージョンをアップグレードする
MongoDBのメジャー バージョンをアップグレードする方法：
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 バージョンに変更します。
重要
アップグレードする前にクラスターの FCV が以前に固定されていた場合を除き、Atlas クラスターのMongoDBバージョンをダウングレードすることはできません。ステージング環境を元のMongoDBバージョンで再デプロイする場合は、クラスターを終了して再作成する必要があります。
Confirm & Deploy をクリックして、変更を配置します。
Atlas で自動的にクラスターのアップグレードが開始されます。Atlas でのクラスターのアップグレードに必要な時間を測定し、本番クラスターのアップグレードについて全体的な予想を立てることを検討します。
アップグレードされたステージング クラスターでバージョン固有の問題が発生した場合は、サポート チケットを申請してください。
アップグレードされたステージング クラスターに対してアプリケーションをテストします。
ステージング クラスターで必要なパフォーマンスおよび操作テストを実行します。
アップグレードされたステージング クラスターでバージョン固有の問題が発生した場合は、サポート チケットを申請してください。
重要
メジャーバージョンアップグレードには、少なくとも 1 回のレプリカセットの選挙が必要です。ステージングクラスターは、プライマリフェイルオーバーに対するアプリケーションの回復力をテストする機会として利用します。詳細なドキュメントについては、「プライマリフェイルオーバーのテスト」を参照してください。
本番クラスターをターゲットの MongoDB バージョンにアップグレードします。
ステージングクラスターのパフォーマンスと操作に問題がなければ、本番クラスターでこれまでのアップグレード手順を繰り返します。
Atlas でのアップグレード プロセスが完了したら、本番アプリケーションが引き続き接続され、正常に動作していることを確認します。
ステージングアプリケーションを新しい MongoDB ドライバにアップグレードして、かつパフォーマンスと操作が満足のいくものであれば、本番アプリケーションのアップグレードのためにメンテナンス期間の予定を立てることを検討します。
アップグレードした本番クラスターで問題が発生した場合は、次のセクションの手順に従って高優先順位のサポートチケットを申請してください。
アップグレード中の機能の互換性 (FCV) の管理
MongoDBのメジャー バージョン アップグレードは、Atlas とオンプレミスの配置の両方でサポートされています。 FCV は、 MongoDBの以前のバージョンと互換性のないデータを保持する機能を有効または無効にします。 Atlas でアップグレードする前にクラスターの FCV を固定することができるため、バージョンの互換性の問題が発生することなく、アップグレード後にMongoDBを以前のバージョンに戻すことができます。
次の手順を使用すると、クラスターの FCV の固定と固定解除、クラスターのメジャー バージョンによるダウングレード、または サポートチケットのファイルができます。
警告
FCV は、固定日から最大 週間のみ保持される短期間の測定値であり、以前のバイナリ4 バージョンの動作をシミュレートすることはありません。新しいサーバー機能を可能にする特定の内部データ構造のアップグレードのみが延期されます。以前のバージョンへのダウングレードが不要であることが確認できたら、現在のバイナリ バージョンと一致するように FCV の固定を解除します。
制限
FCV 固定は専用クラスターでのみ使用できます。
FCV 4の固定は、固定日から 週間以上延長することはできません。
FCV 固定は、Rapid Release のクラスターではサポートされていません。
クラスターのバージョンのサポートが終了する前に、クラスターの FCV を固定する必要があります。
クラスターの FCV のピン留め
クラスターにピン留めされた FCV がある場合、クラスターVersion カードの下部にあるクラスターの の横にピン アイコンが表示されます。カーソルをピンアイコンにカーソルを合わせると、FCV と有効期限を表示するツールチップが表示されます。
Atlas は、有効期限が 以降、または 以降の次回のメンテナンスウィンドウでクラスターの FCV の固定を解除します。
クラスターのMongoDBバージョンをすでにアップグレードしている場合は、固定の有効期限が切れると、Atlas は FCV をMongoDBバージョンと一致するようにアップグレードします。
クラスターの FCV を固定するには次の手順に従います。
AtlasGoClustersAtlas で、プロジェクトの ページにGoします。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。
[ Clusters （クラスター） ] ページが表示されます。
有効期限を設定します。
すべての日付は、UTC の ISO8601 日付と時刻形式で、MM/DD/YYYY 形式の タイムスタンプ に設定されます。 FCV の有効期限は、FCV を固定した日付から 4 週間以内に設定します。有効期限が経過すると、ツールチップにExpired XX/XX/XXXX が表示されます。 FCV キーは4 週間後に自動的に期限切れになります。
FCV 固定の有効期限が切れると、Atlas は、有効期限が 以降、または 以降のメンテナンスウィンドウでクラスターの FCV の固定を解除します。クラスターのMongoDBバージョンをすでにアップグレードしている場合は、Atlas はMongoDBバージョンと一致するように FCV をアップグレードします。
APIを使用してクラスターの FCV を固定するには、「 1 つのプロジェクトの 1 つのクラスターの FCV を固定する 」を参照してください。
クラスターの FCV の固定を解除します
クラスターの FCV の固定を解除するには:
AtlasGoClustersAtlas で、プロジェクトの ページにGoします。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。
[ Clusters （クラスター） ] ページが表示されます。
APIを使用してクラスターの FCV の固定を解除するには、「 1 つのプロジェクトの 1 つのクラスターの FCV の固定を解除する 」を参照してください。
クラスターを 1 つのメジャー バージョンでダウングレード
クラスターのバージョンのダウングレードには次の制限が適用されます。
アップグレードする前にクラスターの FCV を固定した場合にのみダウングレードできます。
クラスターは、固定された FCV に一致するメジャー バージョンにのみダウングレードできます。
このアクションは、ピン留めされた FCV が現在の FCV より 1 つだけ下で、Rapid Release が有効になっていない場合にのみ実行できます。
サポート終了が近づいているバージョンには、ダウングレードできません。
クラスターを 1 段階のメジャー バージョンでダウングレードするには、以下の手順を行います。
AtlasGoClustersAtlas で、プロジェクトの ページにGoします。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。
[ Clusters （クラスター） ] ページが表示されます。
クラスター フォームの Additional Settings セクションで、Select a Version の横にあるドロップダウンから、クラスターの FCV に一致するメジャー バージョンを選択します。
クラスターのMongoDBバージョンがダウングレードされることを示す警告バナーが表示されます。
APIを使用してクラスターを 1 つのメジャー バージョンでダウングレードするには、「 1 つのプロジェクトから 1 つのクラスターを変更する 」を参照してください。
サポートお問い合わせ
このドキュメントで説明されている範囲外で移行のサポートに関して質問がある場合、または移行中にエラーが発生した場合は、Atlas のユーザーインターフェイスからサポートチケットを申請してください。