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

このガイドの内容

• メンテナンスモードについて
• メンテナンスモードの即時有効化あるいは後のためのメンテナンスウィンドウのスケジューリング
• GitHub Enterprise Server APIでのメンテナンスモードのスケジューリング
• クラスタ内の全ノードでのメンテナンスモードの有効化もしくは無効化

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

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

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

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

インスタンスがメンテナンスモードに入ると、通常のHTTP及びGitアクセスはすべて拒否されます。 Git fetch、clone、pushの操作も、サイトが一時的に利用できなくなっていることを示すエラーメッセージと共に拒否されます。 サイトにブラウザーでアクセスすると、メンテナンスページが表示されます。

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

1. In the upper-right corner of any page, click .

   

2. 左サイドバーで [Management Console] をクリックします。

   

3. Management Consoleの上部でMaintenance（メンテナンス）をクリックしてください

   

4. "Enable and schedule（有効化とスケジュール）"の下で、即時にメンテナンスモードを有効化するか、将来にメンテナンスウィンドウをスケジューリングするかを決めてください。

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

5. Enable maintenance mode（メンテナンスモードの有効化）を選択してください。

   

6. Under the left sidebar, click Save settings.

   

GitHub Enterprise Server APIでのメンテナンスモードのスケジューリング

GitHub Enterprise Server APIでは、様々な時間や日付にメンテナンスをスケジューリングできます。 詳しい情報についてはGitHub 開発者ドキュメンテーションの"管理コンソール"を参照してください。

クラスタ内の全ノードでのメンテナンスモードの有効化もしくは無効化

ghe-cluster-maintenanceユーティリティを使えば、クラスタ内のすべてのノードでメンテナンスモードの設定や解除ができます。

$ ghe-cluster-maintenance -h
# オプションの表示
$ ghe-cluster-maintenance -q
# 現在のモードの問い合わせ
$ ghe-cluster-maintenance -s
# メンテナンスモードの設定
$ ghe-cluster-maintenance -u
# メンテナンスモードの解除