ホットパッチでのアップグレード

ホットパッチを使用して、 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] を使用したホットパッチのインストール

自動更新を有効にすると、 [Management Console] を使用してホットパッチを使用してアップグレードできます。アップグレード可能な最新バージョンの GitHub Enterprise Server が表示されます。

提示されているアップグレードターゲットがパッチリリースではなく機能リリースである場合、 [Management Console] を使用してホットパッチをインストールすることはできません。代わりに管理シェルを使ってホットパッチをインストールする必要があります。

自動更新を有効にする。詳しくは、「自動アップデートチェックの有効化」をご覧ください。
GitHub Enterprise Server の管理アカウントから、任意のページの右上隅にあるをクリックします。
[サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。
[ Site admin] サイドバーで、[[Management Console]] をクリックします。
上部のナビゲーションバーで [更新プログラム] をクリックします。
新しいホットパッチがダウンロードされている場合、 [パッケージのインストール] ドロップダウンメニューを選択します。
- すぐにインストールするには、 [今すぐ] をクリックします。
- 後でインストールするなら、後の日付を選択してください。
[インストール] をクリックします。

管理シェルを使ったホットパッチのインストール

メモ

自動更新チェックを有効にすると、アップグレードパッケージをダウンロードする必要はなく、自動的にダウンロードされたファイルを利用できます。詳しくは、「自動アップデートチェックの有効化」をご覧ください。

お使いの 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
```
追加ノードごとに上記の手順を繰り返します。

この記事で

ホットパッチを使用したスタンドアロン インスタンスのアップグレード