ホットパッチを使って GitHub Enterprise Server を最新のパッチ リリースにアップグレードできます。
ホットパッチは新しいパッチリリースへのアップグレードに利用できますが、新しいフィーチャリリースへのアップグレードには利用できません。 たとえば、2.10.1 から 2.10.5 は同じ機能シリーズに含まれているためアップグレードできますが、2.10.9 から 2.11.0 は異なる機能シリーズに含まれているためアップグレードできません。
ホットパッチでは常に再起動が必要とは限りません。 ホットパッチをインストールすると、更新プログラムを完了するためにいずれかのパッケージで再起動が必要な場合に、ターミナルにメッセージが表示されます。 この再起動は便利なタイミングでスケジュールできますが、特にセキュリティ修正プログラムがある場合は、できるだけ早く再起動することをお勧めします。
ホットパッチには構成実行が必要です。構成実行すると、お使いの GitHub Enterprise Server インスタンス の一部または全部のサービスで短い時間、エラーが発生したり、応答しなかったりすることがあります。 ホットパッチのインストール中はメンテナンス モードを有効にする必要はありませんが、有効にすると、エラーまたはタイムアウトではなくメンテナンス ページがユーザーに表示されます。 「メンテナンスモードの有効化とスケジューリング」をご覧ください。
[Management Console] を使うと、ホットパッチをすぐにインストールすることや、後でインストールするようにスケジュールすることができます。 管理シェルで、ghe-upgrade
ユーティリティを使ってホットパッチをインストールすることもできます。 「アップグレード プロセスの概要」および「アップグレードの要求事項」を参照してください。
ホットパッチを使用したスタンドアロン インスタンスのアップグレード
ホットパッチを使用して 1 つのノードを持つインスタンスをアップグレードしており、ターゲットがパッチ リリースである場合は、[Management Console]を使ってアップグレードできます。 機能のリリースにアップグレードするには、管理シェルを使用する必要があります。
[Management Console] を使ってホットパッチをインストールする
[Management Console] を使って自動更新を有効にすることで、ホットパッチを使ってアップグレードできます。 そうすると、アップグレード可能な GitHub Enterprise Server の最新バージョンが表示されます。
表示されたアップグレード ターゲットがパッチ リリースではなく、機能リリースであった場合は、[Management Console] を使ってホットパッチをインストールすることはできません。 代わりに管理シェルを使ってホットパッチをインストールする必要があります。
-
自動更新を有効にする。 詳しくは、「自動アップデートチェックの有効化」を参照してください。
-
GitHub Enterprise Server の管理アカウントから、任意のページの右上隅で をクリックします。
-
[サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。
-
[ サイト管理者] サイドバーで [Management Console] をクリックします。
-
上部のナビゲーション バーで [更新プログラム] をクリックします。
-
新しいホットパッチがダウンロードされている場合、 [パッケージのインストール] ドロップダウン メニューを選択します。
- すぐにインストールするには、 [今すぐ] をクリックします。
- 後でインストールするなら、後の日付を選択してください。
-
[インストール] をクリックします。
管理シェルを使ったホットパッチのインストール
Note
自動更新チェックを有効にすると、アップグレード パッケージをダウンロードする必要はなく、自動的にダウンロードされたファイルを利用できます。 詳しくは、「自動アップデートチェックの有効化」を参照してください。
-
お使いの GitHub Enterprise Server インスタンス に SSH で接続します。 インスタンスが複数のノードで構成されている場合は (高可用性や geo レプリケーションが構成されている場合など)、プライマリ ノードに SSH 接続します。 クラスターを使用する場合は、任意のノードに SSH 接続できます。 HOSTNAME をインスタンスのホスト名、またはノードのホスト名または IP アドレスに置き換えます。 詳しくは、「管理シェル (SSH) にアクセスする」を参照してください。
Shell ssh -p 122 admin@HOSTNAME
ssh -p 122 admin@HOSTNAME
-
GitHub Enterprise Server リリース ページを参照します。 アップグレード先対象リリースの横にある [ダウンロード] をクリックし、 [アップグレード] タブをクリックします。アップグレードのホットパッケージ ( .hpkg ファイル) の URL をコピーします。
-
curl
を使って、アップグレード パッケージを お使いの GitHub Enterprise Server インスタンス にダウンロードします。admin@HOSTNAME:~$ curl -L -O UPGRADE-PKG-URL
-
このパッケージ ファイル名を使って
ghe-upgrade
コマンドを実行します。admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg *** verifying upgrade package signature...
-
少なくとも 1 つのサービスまたはシステム コンポーネントで再起動が必要な場合は、ホットパッチ アップグレード スクリプトによって通知されます。 たとえば、カーネル、MySQL、Elasticsearch の更新には再起動が必要な場合があります。
ホットパッチを使用した複数のノードを持つインスタンスのアップグレード
ホットパッチをインストールする場合、メンテナンス モードに切り替えたり、レプリケーションを停止したりする必要はありません。
ホットパッチを使用したプライマリ ノードのアップグレード
プライマリ ノードをアップグレードする手順については、「管理シェルを使ったホットパッチのインストール」を参照してください。
ホットパッチを使用した追加ノードのアップグレード
高可用性や geo レプリケーション構成など、複数のノードから構成されるインスタンスをアップグレードするには、レプリカ ノードごとに、一度に 1 つずつ、次の手順を繰り返す必要があります。
-
ノードをアップグレードするには、「管理シェルを使ったホットパッチのインストール」の手順に従います。
-
ポート 122 の SSH 経由でレプリカ ノードに
admin
ユーザーとして接続します。ssh -p 122 admin@REPLICA_HOST
-
以下を実行して、アップグレードを検証してください。
ghe-version
-
追加ノードごとに上記の手順を繰り返します。