メンテナンスモード
メンテナンスモードにより、管理者はメンテナンス期間中にシステムアクセスを制限できます。メンテナンスモードが有効になっている場合、管理者のみがシステムにアクセスでき、他のすべてのユーザーはログインがブロックされます。この機能により、メンテナンス中の制御されたアクセスを提供し、無限リダイレクトループを防ぎます。
メンテナンスモードは、管理者が以下を実行できるシステム全体の機能です：
- アクセス制限: メンテナンス中に非管理者ユーザーのシステムアクセスをブロック
- 管理者アクセス: 管理者はメンテナンスタスクを実行するためにシステムにアクセス可能
- ユーザー通信: ユーザーに明確なメンテナンスメッセージを表示
- 簡単な切り替え: 管理インターフェースからメンテナンスモードを有効/無効化
メンテナンスモードの有効化
Section titled “メンテナンスモードの有効化”メンテナンスモードを有効にするには：
- 管理者としてログイン
- 管理 → サーバー → メンテナンスモードに移動
- **「メンテナンスモードを有効化」**スイッチをオンに切り替え
- **「変更を保存」**をクリック
システムはメンテナンスモードになりました。非管理者ユーザーがシステムにアクセスしようとすると、メンテナンスメッセージが表示されます。
メンテナンスモードの無効化
Section titled “メンテナンスモードの無効化”メンテナンスモードを無効にするには：
- 管理者としてログイン（まだログインしていない場合）
- 管理 → サーバー → メンテナンスモードに移動
- **「メンテナンスモードを有効化」**スイッチをオフに切り替え
- **「変更を保存」**をクリック
システムはすべてのユーザーがアクセス可能になりました。
メンテナンス中のアクセス制御
Section titled “メンテナンス中のアクセス制御”メンテナンスモードが有効になっている場合、以下のアクセスルールが適用されます：
許可されたルート
Section titled “許可されたルート”/login- 管理者がログインするため/admin/maintenance- 管理者がメンテナンスモードを無効化するため/api/*- APIアクセス（システム操作に必要になる場合があります）
ブロックされたルート
Section titled “ブロックされたルート”- 非管理者ユーザーの他のすべてのルート
- ルートルート（
/）は非管理者ユーザーにメンテナンスメッセージを表示
ユーザーエクスペリエンス
Section titled “ユーザーエクスペリエンス”非管理者ユーザー
Section titled “非管理者ユーザー”メンテナンスモードが有効になっている場合、非管理者ユーザーは：
- ルートルートでメンテナンスメッセージを確認
- ログインページにアクセス可能（管理者ログインを許可）
- 明確なメッセージを確認：「システムは現在メンテナンス中です。後でもう一度お試しください。」
管理者は：
- すべてのルートに通常どおりアクセス可能
- メンテナンスページにアクセスしてメンテナンスモードを無効化可能
- 制限なくメンテナンスタスクを実行可能
メンテナンス設定
Section titled “メンテナンス設定”メンテナンスモードは、Payload CMSのMaintenanceSettingsグローバルコレクションに保存されます。設定には以下が含まれます：
maintenanceMode: ブール値フィールド（デフォルト：false）- 永続性のためにデータベースに保存
- 管理インターフェースからアクセス可能
エラーハンドリング
Section titled “エラーハンドリング”システムには、無限リダイレクトループを防ぐための適切なエラーハンドリングが含まれています：
- リダイレクト前にルートルートにいるかどうかを確認
- ルートルートにいる場合、リダイレクトの代わりにエラーをスロー
- エラーバウンダリがメンテナンスメッセージを表示
- リダイレクトループを防止
HTTPステータスコード
Section titled “HTTPステータスコード”メンテナンスモードが有効になっている場合、システムは以下を返します：
- HTTP 503（サービス利用不可）ステータスコード
- ユーザーへの明確なエラーメッセージ
- エラーバウンダリでの適切なエラーハンドリング
ベストプラクティス
Section titled “ベストプラクティス”メンテナンスモードを有効にする前
Section titled “メンテナンスモードを有効にする前”- ユーザーに通知: スケジュールされたメンテナンスについて事前にユーザーに通知
- メンテナンスを計画: 低トラフィック期間中にメンテナンスをスケジュール
- アクセスをテスト: 管理者がシステムにアクセスできることを確認
- ロールバックを準備: 必要に応じてメンテナンスモードを無効化する方法を知る
メンテナンス中
Section titled “メンテナンス中”- アクセスを監視: 管理者がシステムにアクセスできることを確認
- タスクを完了: 必要なすべてのメンテナンスタスクを実行
- システムをテスト: システムが正しく動作することを確認
- モードを無効化: 完了したらメンテナンスモードを無効化
メンテナンス後
Section titled “メンテナンス後”- アクセスを確認: すべてのユーザーがシステムにアクセスできることを確認
- 機能を確認: すべてが機能することを確認するために主要な機能をテスト
- ログを監視: 問題がないかシステムログを確認
- ユーザーに通信: メンテナンスが完了したことをユーザーに通知
トラブルシューティング
Section titled “トラブルシューティング”メンテナンスページにアクセスできない
Section titled “メンテナンスページにアクセスできない”メンテナンスページにアクセスできない場合：
- 管理者としてログインしていることを確認
- ルート
/admin/maintenanceがアクセス可能であることを確認 - メンテナンスモードがアクセスをブロックしていないことを確認
- まずログインページにアクセスしてみる
メンテナンスモードが無効化できない
Section titled “メンテナンスモードが無効化できない”メンテナンスモードが無効化できない場合：
- 管理者としてログインしていることを確認
- 管理インターフェースでエラーメッセージを確認
- データベース接続を確認
- エラーのシステムログを確認
無限リダイレクトループ
Section titled “無限リダイレクトループ”無限リダイレクトループが発生する場合：
- システムがこれを自動的に防ぐ必要があります
- ルートルート（
/）にいることを確認 - エラーバウンダリが正しく動作していることを確認
- エラーのシステムログを確認
