クラスタのアップグレード

GitHub Enterprise Server クラスターへのアップグレードについて

GitHub Enterprise Server は常に改善されており、機能リリースとパッチリリースを通じて新しい機能やバグ修正が導入されています。インスタンスへのアップグレードは自身の責任で行ってください。詳しくは、「新しいリリースへのアップグレードについて」をご覧ください。

インスタンスをアップグレードするには、アップグレードの計画と通知、適切なパッケージの選択、データのバックアップ、アップグレードの実行が必要になります。

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

ホットパッチを使って GitHub Enterprise Server を最新のパッチリリースにアップグレードできます。

ホットパッチは新しいパッチリリースへのアップグレードに利用できますが、新しいフィーチャリリースへのアップグレードには利用できません。たとえば、2.10.1 から 2.10.5 は同じ機能シリーズに含まれているためアップグレードできますが、2.10.9 から 2.11.0 は異なる機能シリーズに含まれているためアップグレードできません。

ホットパッチでは常に再起動が必要とは限りません。ホットパッチをインストールすると、更新プログラムを完了するためにいずれかのパッケージで再起動が必要な場合に、ターミナルにメッセージが表示されます。この再起動は便利なタイミングでスケジュールできますが、特にセキュリティ修正プログラムがある場合は、できるだけ早く再起動することをお勧めします。

ホットパッチには構成実行が必要です。構成実行すると、お使いの GitHub Enterprise Server インスタンスの一部または全部のサービスで短い時間、エラーが発生したり、応答しなかったりすることがあります。ホットパッチのインストール中はメンテナンスモードを有効にする必要はありませんが、有効にすると、エラーまたはタイムアウトではなくメンテナンスページがユーザーに表示されます。「メンテナンスモードの有効化とスケジューリング」をご覧ください。ホットパッチのインストールスクリプトは、ホットパッチをクラスタ内の各ノードにインストールし、サービスを適切な順序で再起動し、ダウンタイムを回避します。

GitHub Enterprise Server Backup Utilities を使用してデータをバックアップします。
任意のノードの管理シェルから、コマンドを使用して最新のホットパッチをインストールします。ホットパッチの URL を指定するか、手動でホットパッチをダウンロードしてローカルのファイル名を指定することができます。
```
ghe-cluster-hotpatch https://HOTPATCH-URL/FILENAME.hpkg
```

アップグレードパッケージでのアップグレード

アップグレードパッケージを使用して、GitHub Enterprise Server クラスタを最新のフィーチャリリースにアップグレードします。たとえば、からにアップグレードできます。

アップグレードの準備

アップグレードするバージョンの AUTOTITLEを確認し、必要に応じて構成を更新します。
GitHub Enterprise Server Backup Utilities を使用してデータをバックアップします。
アップグレード中は通常どおりに使用できないため、GitHub Enterprise Serverクラスタのエンドユーザーに対してメンテナンス期間をスケジュールします。メンテナンスモードは、クラスタのアップグレードの進行中、ユーザーのアクセスをブロックし、データが変更されないようにします。
GitHub Enterprise Server のダウンロードページで、アップグレード .pkg ファイルの URL をクリップボードにコピーします。

任意のノードの管理シェルから、コマンドをと組み合わせて使用して、1 つの手順でリリースパッケージを各ノードにダウンロードします。先ほどのステップでコピーした URL を引数として使ってください。

$ ghe-cluster-each -- "cd /home/admin && curl -L -O https://PACKAGE-URL.pkg"
> ghe-app-node-1:   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
> ghe-app-node-1:                                  Dload  Upload   Total   Spent    Left  Speed
> 100  496M  100  496M    0     0  24.2M      0  0:00:20  0:00:20 --:--:-- 27.4M
> ghe-data-node-2:   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
> ghe-data-node-2:                                  Dload  Upload   Total   Spent    Left  Speed
> 100  496M  100  496M    0     0  21.3M      0  0:00:23  0:00:23 --:--:-- 25.8M
> ghe-data-node-1:   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
> ghe-data-node-1:                                  Dload  Upload   Total   Spent    Left  Speed
> 100  496M  100  496M    0     0  19.7M      0  0:00:25  0:00:25 --:--:-- 25.6M
> ghe-app-node-2:   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
> ghe-app-node-2:                                  Dload  Upload   Total   Spent    Left  Speed
> 100  496M  100  496M    0     0  19.8M      0  0:00:25  0:00:25 --:--:-- 17.6M
> ghe-data-node-3:   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
> ghe-data-node-3:                                  Dload  Upload   Total   Spent    Left  Speed
> 100  496M  100  496M    0     0  19.7M      0  0:00:25  0:00:25 --:--:-- 25.5M

でとして定義されているプライマリ MySQL ノードを特定します。このノードは最後にアップグレードされます。

クラスタノードのアップグレード

任意のクラスターノードの管理シェルに接続してを実行して、スケジュールされた期間に従ってメンテナンスモードを有効にします。
を実行して、任意のノードの管理シェルからメンテナンスモードを終了します。