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

ホットパッチを使って 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 の管理アカウントから、任意のページの右上隅でをクリックします。
[サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。
[ サイト管理者] サイドバーで [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
```
追加ノードごとに上記の手順を繰り返します。

この記事の内容

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