メンテナンスモードの有効化とスケジューリング

メンテナンスモードについて

操作の種類によっては、お使いの GitHub Enterprise Server インスタンス をオフラインにしてメンテナンス モードにする必要があります。

• GitHub Enterprise Server の新規バージョンにアップグレードする
• 仮想マシンに割り当てられている CPU、メモリ、またはストレージリソースを拡大する
• ある仮想マシンから別の仮想マシンへデータを移行する
• GitHub Enterprise Server Backup Utilities スナップショットからデータを復元する
• 特定の種類の重要なアプリケーション問題のトラブルシューティング

メンテナンスウィンドウのスケジュールは、ユーザに準備時間を与えるために少なくとも30分は先にすることをおすすめします。 メンテナンスウィンドウがスケジューリングされると、すべてのユーザにはサイトにアクセスしたときにバナーが表示されます。

インスタンスがメンテナンスモードに入ると、通常のHTTP及びGitアクセスはすべて拒否されます。 これには、アプライアンスが状態コード 503 (サービス利用不可) で応答する Web 要求と API 要求が含まれます。 Git fetch、clone、pushの操作も、サイトが一時的に利用できなくなっていることを示すエラーメッセージと共に拒否されます。 高可用性構成では、Git レプリケーションは一時停止されます。 GitHub Actions ジョブは実行されません。 サイトにブラウザーでアクセスすると、メンテナンスページが表示されます。

メンテナンス操作の初期検証を実行するには、指定された IP アドレスと範囲からのみ お使いの GitHub Enterprise Server インスタンス へのアクセスを許可するように IP 例外リストを構成します。 IP 例外リストで指定されていない IP アドレスから お使いの GitHub Enterprise Server インスタンス にアクセスしようとすると、インスタンスがメンテナンス モードのときに送信された応答と一致する応答を受け取ります。

メンテナンスモードの即時有効化あるいは後のためのメンテナンスウィンドウのスケジューリング

1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅で をクリックします。

2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。

3. [ サイト管理者] サイドバーで [Management Console] をクリックします。

4. 上部のナビゲーション バーで [メンテナンス] をクリックします。

   

5. [有効化とスケジュール] で メンテナンス モードをすぐに有効にするか、今後のメンテナンス期間をスケジュールするかを決めます。

   • メンテナンス モードを直ちに有効にするには、ドロップダウン メニューを選んで [今すぐ] をクリックします。
   • 今後のメンテナンス期間をスケジュール設定するには、ドロップダウン メニューを選んで開始時間をクリックします。

6. ウィンドウのタイミングに問題がなければ、[メンテナンス モードを有効にする] の横にあるチェック ボックスをオンにします。 [今すぐ] を選択した場合、インスタンスはすぐにメンテナンス モードになります。

IP 例外リストを使い、メンテナンス モードで変更を検証する

IP 例外リストは、お使いの GitHub Enterprise Server インスタンス への制御および制限付きアクセスを提供します。これは、メンテナンス操作後のサーバー正常性の初期検証に最適です。 有効にすると、お使いの GitHub Enterprise Server インスタンス はメンテナンス モードから外され、構成済みの IP アドレスでのみ使用できるようになります。 メンテナンス モードのチェック ボックスは、状態の変化を反映するように更新されます。

メンテナンス モードを再度有効にすると、IP 例外リストが無効になり、お使いの GitHub Enterprise Server インスタンス がメンテナンス モードに戻ります。 IP 例外リストを無効にした場合、お使いの GitHub Enterprise Server インスタンス は通常の操作に戻ります。

コマンド ライン ユーティリティを使って IP 例外リストを構成することもできます。 詳細については、「コマンド ライン ユーティリティ」および「管理シェル (SSH) にアクセスする」を参照してください。

1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅で をクリックします。

2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。

3. [ サイト管理者] サイドバーで [Management Console] をクリックします。

4. 上部のナビゲーション バーで [メンテナンス] をクリックし、メンテナンス モードが既に有効になっていることを確認します。

   

5. [IP 例外リストの有効化と構成] で [IP 例外リストの有効化] を選びます。

6. 一覧を有効にするチェック ボックスの右側に、お使いの GitHub Enterprise Server インスタンス へのアクセスを許可する必要がある、空白で区切られた IP アドレスまたは CIDR ブロックの有効な一覧を入力します。

7. [保存] をクリックします。

GitHub Enterprise Server APIs

でのメンテナンスモードのスケジューリング

GitHub Enterprise Server APIs では、様々な時間や日付にメンテナンスをスケジューリングできます。 詳しくは、「管理コンソール用の REST API エンドポイント」を参照してください。