Atlas がプロジェクトのメンテナンスをロールアウトする方法は、以下を設定することで管理できます。
保護された時間: 標準更新を実行できないビジネスクリティカル 時間。
メンテナンスWindows: Atlas が週次メンテナンスを開始する時刻で、プロジェクト内のクラスターのレプリカセット選挙が必要です。
メンテナンス シーケンス:組織内のプロジェクトがメンテナンスを受信する順序です。メンテナンス シーケンスは、Wave 1 からLast Wave までのラベルの付いたサーバーで連続して構成します。
プロジェクション メンテナンス スケジュール ツールを使用して、メンテナンスウィンドウ、保護された時間、メンテナンス シーケンス構成を指定して、Atlas がプロジェクトにメンテナンスをどのようにロールアウトするかを視覚化できます。
重要
メンテナンスウィンドウ、保護されている時間、メンテナンス シーケンスはプロジェクトごとに構成され、専用クラスター（M10 以上）にのみ適用されます。無料クラスターと Flex クラスターの場合、Atlas はメンテナンスウィンドウを自動的に管理し、手動で設定することはできません。
メンテナンスウィンドウ、保護されている、メンテナンス シーケンスはすべてオプションですが、 に設定することをお勧めします。 Atlas は、回復力のあるアプリケーションの継続的な可用性を維持するために、メンテナンスを自動的にローリング方式で実行します。アプリケーションがレプリカセットの選挙に対して回復力があることを確認するには、Atlas でフェイルオーバーをテスト します。
メンテナンス マネジメントに関する考慮事項
保護された時間帯: メンテナンスウィンドウの構成に加えて、毎日保護された時間帯を設定することもできます。これは、Atlas が実行する標準の更新を回避するための時間帯です。Atlas はメンテナンスウィンドウ中にメンテナンスを自動的に実行します。
ただし、Atlas はメンテナンスウィンドウ外で、クラスターの再起動やワークロードパフォーマンスに影響を及ぼさない標準的な更新を実行する場合があります。保護された時間を有効にすると、Atlas は保護された時間枠外で標準更新を実行します。保護された時間帯は18時間を超えることはできません。
至急の整備アクティビティ: Atlas は、設定されたメンテナンスウィンドウや保護された時間帯に関係なく、必要に応じて至急の整備アクティビティ（ゼロデイ脆弱性に対するセキュリティパッチなど）を実行することがあります。
継続的なメンテナンス操作: クラスターのメンテナンスウィンドウを予定すると、進行中のメンテナンス操作が完了するまで変更できません。
MongoDB データベースのアップグレード: メンテナンスに MongoDB マイナーバージョンまたはパッチバージョンのアップグレードが含まれる場合、Atlas は現在のバージョンと対象バージョンをコンソールに表示します。Atlas が次回のメンテナンスウィンドウ中にいずれかのクラスターの MongoDB メンテナンスバージョンをアップグレードする場合、クラスターのカードには対象の MongoDB メンテナンスバージョンが表示されます。
メンテナンスにはレプリカセットの選挙が必要です。Atlas は、 MongoDBマニュアル に記載されているメンテナンス手順と同じ方法でメンテナンスを実行します。この手順では、 レプリカセットごとに、メンテナンスウィンドウ中に少なくとも 1 回のレプリカセット選挙が必要です。アプリケーションがレプリカセットの選挙に対して回復力があることを確認するには、Atlas でフェイルオーバーをテスト します。
メンテナンスは可能な限りウィンドウの開始時間に近い時間で開始します: メンテナンスは常に可能な限り予定時刻に近い時間に開始されますが、進行中のクラスター更新や予期しないシステム問題により、開始時間が遅れる可能性があります。
メンテナンス中の一時的なパフォーマンス低下の可能性: ディスク IOPS が低い場合、MongoDB が WiredTiger ストレージエンジンを再構築する間、クラスターのパフォーマンスがメンテナンス中一時的に低下する可能性があります。詳しくは、「ジャーナリングと WiredTiger ストレージエンジン」をご覧ください
デフォルトのメンテナンス シーケンス: Atlas は、次のルールを使用して、明示的な割り当てがないプロジェクトにメンテナンス レームを自動的に割り当てます。
Atlas は、メンテナンスウィンドウが構成されていないプロジェクトを Write 01 に割り当てます。
Atlas は、構成済みのメンテナンスウィンドウを持つプロジェクトを Write 02 に割り当てます。
メンテナンス シーケンスの評価: Atlas は、メンテナンスイベントが最初に発生したときに構成されたメンテナンス シーケンスを評価します。メンテナンスイベントが開始されから完了するまでの間にメンテナンス シーケンスに変更を加えると、Atlas は次回の メンテナンスイベントの開始時に新しいメンテナンス シーケンスの使用を開始します。
メンテナンス間の時間: メンテナンス48 シーケンスが設定されている場合、Atlas がメンテナンスを 1 つのタームにロールアウトするまでと次のタームにメンテナンスをロールアウトするまでには少なくとも 時間のギャップがあります。 Atlas がWave 1 から始まる次のレイテンシに進む前に、特定のレイテンシに割り当てられたすべてのプロジェクトのメンテナンスが完了している必要があります。
定期メンテナンス操作の種類
Scheduled Maintenance Operations モーダルには、次のメンテナンス タイプが 1 つ以上表示される場合があります。
MongoDB必要なメンテナンス: クラスターの健全性と安定性のために必要な重要なメンテナンス操作。
MongoDB のバージョン更新: MongoDB のマイナー バージョン、パッチ バージョン、またはメンテナンス リリースにアップグレードします。
OS ポリシー バージョンの更新: 基礎のオペレーティング システム ポリシーとセキュリティ パッチを更新します。
その他のメンテナンス操作: クラスター マネジメントに必要な追加のメンテナンス アクティビティ。
メンテナンスの完了を追跡する
メンテナンス操作が完了すると、プロジェクト アクティビティフィードにMaintenance window completedイベントが表示されます。
今後のメンテナンスウィンドウの自動延期を有効にする
Automatically defer maintenance for one week オプションを有効にすると、Atlas は自動的に将来のスケジュールされたメンテナンスを毎回1週間延期します。つまり、毎回最初の週が自動的に延期されるため、メンテナンスは実質的に毎週ではなく2週間ごとに実行されます。必要に応じて、メンテナンスを手動でさらに延期することもできます。
重要
組織内のプロジェクトに対してメンテナンス シーケンスが構成されている場合、その組織内のプロジェクトに対して自動延期するメンテナンスを構成することはできません。
Automatically defer maintenance for one weekオプションを有効にすると、Atlas は将来のメンテナンスウィンドウに対して自動延期を設定します。現在スケジュールされているメンテナンスを延期するには、メンテナンスの延期セクションに記載されている Defer 1 Week オプションを使用します。
自動延期機能を使用すると、以下が可能になります。
メンテナンス頻度を減らす: 自動延期を 1 回設定すると、メンテナンス操作は毎週ではなく 2 週間ごとに実行されるようにします。
バッチ更新: メンテナンス操作を 1 つのメンテナンスウィンドウに統合し、メンテナンス イベントの総数を減らします。
最初に低い環境でテストします。実稼働環境で 自動延期 を設定し、開発またはステージングでメンテナンスが毎週実行されるようにします。これにより、本番環境に到達する前に更新を検証する時間ができます。
自動延期を有効にするには、「メンテナンスウィンドウの表示と構成」のセクションをご覧ください。
必要なアクセス権
メンテナンスWindowsを管理するには、プロジェクトに対するOrganization OwnerまたはProject Ownerアクセス権が必要です。
プロジェクトのメンテナンスウィンドウとシーケンスを設定する
メンテナンスウィンドウとシーケンスの表示と設定
プロジェクトのメンテナンスウィンドウ、保護されている時間、メンテナンス シーケンスは、組織の 設定またはそのプロジェクトの 設定から構成できます。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
サイドバーで、Organization Settings をクリックします。
[ Organization Settings ]ページが表示されます。
Maintenance Window and Sequence セクションには、組織内のプロジェクトに設定したメンテナンスウィンドウとシーケンスが表示されます。 Atlas UIを使用して、組織の 設定からメンテナンス シーケンスを構成するには次の手順に従います。
[Edit sequence for all projects] をクリックします。
プロジェクトにメンテナンスウィンドを手動で割り当てるには、Manual Assignment を選択します。
各プロジェクトの横にあるドロップダウンを使用して、メンテナンスウィンドを割り当てます。
プロジェクトに環境プロジェクトタグが設定されている場合は、Generate sequences based on existing project tags オプションを使用できます。
Atlas は、環境プロジェクトタグに基づいて次の割り当てを生成します。これらのプロジェクトタグは、メンテナンス 頻度の割り当てにのみ使用できます。
開発/テスト: Write1
ステージング: のみ2
本番環境: 最終回
プロジェクトの環境タグを更新しても、Atlas はこれらの割り当てを自動的に更新しません。
Manual Assignment を選択している場合は、 プロジェクトのメンテナンスウィンドウを構成する のと同様に、プロジェクトのメンテナンス シーケンスを構成することもできます。
プロジェクトのメンテナンスウィンドを環境プロジェクトタグにリンクするには、Use Project Tags to auto-define sequence を選択します。
Atlas は、環境プロジェクトタグに基づいて次の割り当てを生成します。これらのプロジェクトタグは、メンテナンス 頻度の割り当てにのみ使用できます。
開発/テスト: Write1
ステージング: のみ2
本番環境: 最終回
Atlas では、プロジェクトの環境タグが更新されると、これらの割り当てが自動的に更新されます。
変更を保持するにはSaveをクリックし、変更を破棄するにはCancelをクリックします。
Atlas UIを使用してプロジェクトのメンテナンスウィンドウを設定するには、次の手順に従います。
メンテナンスウィンドウを構成する 1 つ以上のプロジェクトを選択します。
単一のプロジェクトのメンテナンスウィンドウを編集するには、プロジェクトの横にある をクリックしてEdit Maintenance Window ページを開きます。
複数のプロジェクトのメンテナンスウィンドウを編集するには、選択するプロジェクトの横にあるチェックボックスをクリックします。次に、[Edit Maintenance Window] をクリックします。
選択したプロジェクトのメンテナンスを開始する日時を Atlas が開始する日時を設定します。
Atlas が標準更新を回避する保護時間の範囲を設定するには、Enable protected hours 設定を On に切り替えます。1 日に最大 18 時間の時間範囲を設定できます。
Atlasがスケジュールされたメンテナンスを 1 週間自動的に延期する場合は、Automatically defer maintenance for one week をクリックします。
このオプションを有効にすると、将来のメンテナンスウィンドウの自動延期が構成されます。現在予定されているメンテナンスを延期するには、Defer 1 Weekボタンを使用します。
重要
メンテナンス シーケンスを使用する場合のメンテナンスの延期
自動延期 メンテナンスは、 メンテナンス シーケンス が設定されているプロジェクトでは使用できません。
メンテナンス シーケンスが設定されたプロジェクトのメンテナンスを延期できるのは、Last Wave に割り当てられている場合のみです。 Atlas では、これらのプロジェクトは最大 1 回の延期に制限されています。
メンテナンス シーケンスを設定するには、Sequence (per project) の下のドロップダウンを使用して、1 つまたは複数のプロジェクトをメンテナンス ウェブに割り当てます。
注意
プロジェクト タグを使用したメンテナンス シーケンスの設定
組織レベルのメンテナンス シーケンス設定で Use Project Tags to auto-define sequence が選択されている場合、プロジェクトの 設定からメンテナンス シーケンスを手動で構成することはできません。
変更を保持するにはSaveをクリックし、変更を破棄するにはCancelをクリックします。
Atlas で、Project Settings ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、 アイコンを Project Overview の横にあるをクリックします。
[ Project Settings ]ページが表示されます。
Maintenance Window and Sequence セクションには、プロジェクトに設定したメンテナンスウィンドウとシーケンスが表示されます。 Atlas UIを使用して、プロジェクトの 設定からメンテナンス シーケンス ウェブを構成するには次のようにします。
メンテナンスウィンドウまたはシーケンスを設定するには、Edit ボタンをクリックします。
Atlas がプロジェクトのメンテナンスを開始する日時を設定します。
Atlas が標準更新を回避する保護時間の範囲を設定するには、Enable protected hours 設定を On に切り替えます。1 日に最大 18 時間の時間範囲を設定できます。
Atlasがスケジュールされたメンテナンスを 1 週間自動的に延期する場合は、Automatically defer maintenance for one week をクリックします。
このオプションを有効にすると、将来のメンテナンスウィンドウの自動延期が構成されます。現在予定されているメンテナンスを延期するには、Defer 1 Weekボタンを使用します。
重要
メンテナンス シーケンスを使用する場合のメンテナンスの延期
自動延期 メンテナンスは、 メンテナンス シーケンス が設定されているプロジェクトでは使用できません。
メンテナンス シーケンスが設定されたプロジェクトのメンテナンスを延期できるのは、Last Wave に割り当てられている場合のみです。 Atlas では、これらのプロジェクトは最大 1 回の延期に制限されています。
メンテナンス シーケンスを設定するには、Sequence (per project) の下のドロップダウンを使用して、1 つまたは複数のプロジェクトをメンテナンス ウェブに割り当てます。
注意
プロジェクト タグを使用したメンテナンス シーケンスの設定
組織レベルのメンテナンス シーケンス設定で Use Project Tags to auto-define sequence が選択されている場合、プロジェクトの 設定からメンテナンス シーケンスを手動で構成することはできません。
変更を保持するにはSaveをクリックし、変更を破棄するにはCancelをクリックします。
Atlas CLI を使用してメンテナンスウィンドウの詳細を返すには、次のコマンドを実行します。
atlas maintenanceWindows describe [options]
Atlas CLI を使用してメンテナンスウィンドウを更新するには、次のコマンドを実行します。
atlas maintenanceWindows update [options]
前のコマンドの構文とパラメーターの詳細については、Atlas CLIドキュメントの「AtlasメンテナンスWindows の説明」および「メンテナンスAtlasWindows Update」を参照してください。
Atlas は、 1 つのプロジェクトの 1 つのメンテナンスウィンドウを更新 エンドポイントと 1 つのプロジェクトの 1 つのメンテナンスウィンドウを取得 エンドポイントを提供します。
注意
この curl コマンドは、サービス アカウント アクセス トークン（OAuth 2.0）を使用して認証します。詳細については、Atlas 管理APIの使い始める を参照してください。
メンテナンスウィンドウの構成設定を削除する
メンテナンスウィンドウ、保護されている時間、またはメンテナンス シーケンスが構成されている場合は、 Atlas UI、 Atlas CLI 、または Atlas Administration APIを使用してこれらの設定を削除できます。メンテナンスウィンドウ構成を削除すると、デフォルトのメンテナンスウィンドウ設定が復元されます。
組織設定
Maintenance Window and Sequence セクションの Delete sequence for all projects をクリックすると、構成されたすべてのメンテナンス シーケンス ウェイ を削除できます。
特定のメンテナンスウィンドウまたはシーケンス図の割り当てを削除するには:
メンテナンス シーケンス ウェイ が設定されている場合は、削除するメンテナンスウィンドウが属するプロジェクトの対応タブをクリックします。
Actionsの下で、削除するメンテナンスウィンドウの横にあるアイコンをクリックします。これにより、メンテナンスウィンドウと割り当てられたシーケンスが削除されます。
メンテナンスウィンドウを削除せずに、割り当てられたメンテナンス シーケンスを削除するには :
メンテナンス シーケンスを削除する 1 つ以上のプロジェクトを選択します。
単一プロジェクトのメンテナンス シーケンス ウェブを削除するには、プロジェクトの横にあるEdit Maintenance Window [] をクリックして ページを開きます。
複数のプロジェクトのメンテナンスウィンドウを削除するには、削除するプロジェクトの横にあるチェックボックスをクリックします。次に、[Edit Maintenance Window] をクリックします。
Sequence (per project) の下のドロップダウンを使用して [None を選択します。
プロジェクト設定
Atlas UI を使用して構成されたメンテナンスウィンドウとシーケンスを削除するには、 セクションのMaintenance Window and Sequence アイコンをクリックします。
メンテナンスウィンドウを削除せずに、割り当てられたメンテナンス シーケンスを削除するには :
Maintenance Window and Sequence セクションで [Edit] をクリックします。
Sequence (per project) の下のドロップダウンを使用して [None を選択します。
変更を保持するにはSaveをクリックし、変更を破棄するにはCancelをクリックします。
Atlas CLI を使用して構成されたメンテナンスウィンドウをクリアするには、次のコマンドを実行します。
atlas maintenanceWindows clear [options]
コマンド構文とパラメーターの詳細については、Atlas CLI AtlasmaintenanceWindows clear の ドキュメントを参照してください。
Atlas は、1 つのプロジェクト エンドポイントの 1 つのメンテナンスウィンドウを更新 を提供します。
注意
この curl コマンドは、サービス アカウント アクセス トークン（OAuth 2.0）を使用して認証します。詳細については、Atlas 管理APIの使い始める を参照してください。
必要なメンテナンスに応答する
メンテナンスが必要な場合:
予定されているメンテナンスの48～72時間前（2～3日前）に、Atlasはプロジェクトのクラスターリストに、メンテナンスが予定されている日時を示すバナーを表示します。Show Detailsをクリックすると、MongoDBのバージョン更新、OSポリシーの更新、その他のメンテナンスの種類など、予定されているメンテナンス操作が表示されます。
Atlas は
Project Ownerロールを持つユーザーにメールを送信し、Atlas UI を更新して、メンテナンスを即時開始するか1週間繰延するかのオプションを表示します。注意
スケジュールされたメンテナンスウィンドウ通知の受信方法を構成するには、「メンテナンスウィンドウ アラートの構成 」を参照してください。
今すぐメンテナンスを開始
メンテナンスをすぐに開始するには:
Atlas で、Project Settings ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、 アイコンを Project Overview の横にあるをクリックします。
[ Project Settings ]ページが表示されます。
左側のナビゲーションの [Database] セクションの下にある [Clusters] をクリックします。
メンテナンス バナーで、View Details または View more scheduled maintenances をクリックします。
Scheduled Maintenance Operations というタイトルのモーダルウィンドウが表示され、スケジュールされた日時と、計画されているメンテナンス操作の種類が表示されます。
メンテナンスバナーで、Show Details をクリックします。Scheduled Maintenance Operations というタイトルのモーダルウィンドウが表示され、予定の日時と計画されているメンテナンス操作の種類が表示されます。
Scheduled Maintenance Operations モーダルで、Begin Now ボタンをクリックします。Start Cluster Maintenance Now 確認モーダルで、Yes, start my maintenance now. をクリックして確認します
Atlas CLI を使用してメンテナンスウィンドウを更新するには、次のコマンドを実行します。
atlas maintenanceWindows update [options]
コマンド構文とパラメーターの詳細については、Atlas CLI ドキュメントの atlasメンテナンスウィンドウの更新 を参照してください。
重要: メンテナンスをすぐにトリガーするには、--startASAP オプションを渡します。
# Trigger immediate maintenance for the project with the ID # 5e2211c17a3e5a48f5497de3: atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json
Atlas は、1 つのプロジェクトのエンドポイントとなる接続されたデバイスの 1 つのメンテナンスウィンドウの更新を提供します。startASAP フィールドに true の値を持つを渡すことで、任意でメンテナンスをすぐにトリガーできます。
注意
この curl コマンドは、サービス アカウント アクセス トークン（OAuth 2.0）を使用して認証します。詳細については、Atlas 管理APIの使い始める を参照してください。
curl --header "Authorization: Bearer {ACCESS-TOKEN}" \ --include \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --header "Content-Type: application/json" \ -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/maintenanceWindow" \ --data ' { "startASAP": true }'
メンテナンスを延期
現在スケジュールされているメンテナンスを1週間延期するには、次の手順に従います。将来のすべてのメンテナンスを自動的に延期するには、自動延期を有効にします。
注意
メンテナンスシーケンスが設定されたメンテナンスの延期
メンテナンス シーケンスが設定されたプロジェクトのメンテナンスを延期できるのは、Last Wave に割り当てられている場合のみです。 Atlas では、これらのプロジェクトは最大 1 回の延期に制限されています。
注意
1 つのプロジェクトのメンテナンス イベントは最大 2 回まで延期できます。
定期メンテナンスを延期するには、以下を行います。
Atlas で、Project Settings ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、 アイコンを Project Overview の横にあるをクリックします。
[ Project Settings ]ページが表示されます。
左側のナビゲーションの [Database] セクションの下にある [Clusters] をクリックします。
メンテナンス バナーで、View Details または View more scheduled maintenances をクリックします。
Scheduled Maintenance Operations というタイトルのモーダルウィンドウが表示され、スケジュールされた日時と、計画されているメンテナンス操作の種類が表示されます。
Scheduled Maintenance Operations モーダルで、Defer 1 Week ボタンをクリックします。Defer Maintenance to Next Week 確認モーダルで、Yes, defer maintenance until next week. をクリックして確認します
注意
1 つのプロジェクトのメンテナンス イベントは最大 2 回まで延期できます。
Atlas CLI を使用してメンテナンスウィンドウを延期するには、次のコマンドを実行します。
atlas maintenanceWindows defer [options]
コマンド構文とパラメーターの詳細については、 Atlas CLIドキュメントのAtlasメンテナンスウィンドウのデフォルトを参照してください。
Atlas は、1 つのプロジェクトの 1 つのメンテナンスウィンドウを延期するエンドポイントとなる接続されたデバイスを提供します。
注意
1 つのプロジェクトのメンテナンス イベントは最大 2 回まで延期できます。
プロジェクション メンテナンス スケジュール ツール
メンテナンスイベントがプロジェクトにロールアウトされるタイミングを視覚化するには、 プロジェクション メンテナンス スケジュール ツールを使用できます。このツールを使用すると、潜在的なメンテナンスウィンドウとシーケンス設定、およびメンテナンス リリース日を入力できます。これらの設定とリリース日を指定すると、ツールには Atlas が各シーケンス 関数のプロジェクトでメンテナンスを実行する日付と時刻が表示されます。
このツールは Atlas アカウントにはリンクされていません。 Atlas で構成した設定を読み取ったり、プロジェクトまたは組織の設定を構成したりすることはできません。