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

この記事では、次の� �目が扱われます。

のアップグレードやバックアップの復元など、一部の標準的なメンテナンス手� �では、通常の使用のためにインスタンスをオフラインにする必要があります。

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

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

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

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

スケジューリングされたメンテナンスに関するエンドユーザ向けバナー

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

メンテナンスモードのスプラッシュスクリーン

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

GitHub Enterprise Server の管理アカウントから、任意のページの右上隅のをクリックします。
[サイト管理者] ページにま� 表示されていない� �合は、左上隅の [サイト管理者] をクリックします。

1. 左側のサイドバーで、 [Management Console] をクリックします。
[Management Console] の上部で [メンテナンス] をクリックしてく� さい
"Enable and schedule（有効化とスケジュール）"の下で、即時にメンテナンスモードを有効化するか、将来にメンテナンスウィンドウをスケジューリングするかを決めてく� さい。
- メンテナンスモードを直ちに有効にするには、ドロップダウンメニューを使用して [今すぐ] をクリックします。
- 今後のメンテナンス時間� をスケジュール設定するには、ドロップダウンメニューを使用して開始時間をクリックします。
[メンテナンスモードを有効にする] を選択します。 1. 左側のサイドバーで、 [設定の保存] をクリックします。

注: [Management Console] に設定を保存すると、システ� サービスが再起動され、ユーザーに表示されるダウンタイ� が発生する可能性があります。
設定の実行が完了するのを待ってく� さい。

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

GitHub Enterprise Server APIsでは、様々な時間や日付にメンテナンスをスケジューリングできます。詳細については、管理コンソールに関する記事を参照してく� さい。

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

この ghe-cluster-maintenance ユーティリティを使用すると、クラスター内のすべてのノードのメンテナンスモードを設定または設定解除できます。

$ ghe-cluster-maintenance -h
# Shows options
$ ghe-cluster-maintenance -q
# Queries the current mode
$ ghe-cluster-maintenance -s
# Sets maintenance mode
$ ghe-cluster-maintenance -u
# Unsets maintenance mode