アップグレードの要求事� �

推奨される対応

• アップグレードのプロセスに含めるアップグレードは、できる� け少なくしてく� さい。 たとえば GitHub Enterprise 3.3 から 3.4 を経て 3.5 にアップグレードする代わりに、GitHub Enterprise 3.3 から 3.5 にアップグレードできます。 Use the Upgrade assistant to find the upgrade path from your current release version.
• バージョンが数バージョン古いのであれば、GitHub Enterprise Serverインスタンスをアップグレードのプロセスの各ステップでできる限り先までアップグレードしてく� さい。 各アップグレードで可能な限りの最新バージョンを使うことで、パフォーマンスの改善やバグフィックスのメリットが得られます。 たとえばGitHub Enterprise2.7から2.8を経て2.10へアップグレードすることができますが、GitHub Enterprise2.7から2.9を経て2.10へのアップグレードすれば、2番目のステップでより新しいバージョンを利用できます。
• アップグレードの際には、最新のパッチリリースを使ってく� さい。 GitHub Enterprise Serverのリリースページにアクセスしてく� さい。 アップグレードしたいリリースの隣の Download（ダウンロード）をクリックし、続いて Upgrading（アップグレード）タブをクリックしてく� さい。
• アップグレードのステップのテストには、ステージングインスタンスを使ってく� さい。 詳しい情� �については "ステージングインスタンスのセットアップ"を参照してく� さい。
• 複数のアップグレードを実行する� �合は、機能のアップグレードの間に少なくとも 24 時間待って、データ移行とバックグラウンドで実行されているアップグレードタスクが完全に完了するようにします。
• Take a snapshot before upgrading your virtual machine. 詳細は「スナップショットを取得する」を参照してく� さい。
• Ensure you have a recent, successful backup of your instance. 詳しい情� �については、GitHub Enterprise ServerバックアップユーティリティREADME.md ファイルを参照してく� さい。

要件

• アップグレードは、最大でも2リリース前のフィーチャリリースから行わなければなりません。 たとえば GitHub Enterprise 3.5 にアップグレードするためには、GitHub Enterprise 3.4 あるいは 3.3 となっていなければなりません。
• When upgrading using an upgrade package, schedule a maintenance window for GitHub Enterprise Server end users.
• GitHub Enterprise Serverは、ホットパッチを利用して最新のパッチリリースへアップグレードできます。ホットパッチにはメンテナンスウィンドウが不要で、通常は再起動も必要ありません。

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

• ホットパッチは、影響するサービス（カーネル、MySQL、Elasticsearchなど）がVMの再起動やサービスの再起動を必要とするなら、ダウンタイ� が必要になります。 リブートや再起動が必要になったときには通知されます。 リブートや再起動は後で完了させることができます。
• ホットパッチでアップグレードをする� �合、アップグレードの完了までに特定のサービスの複数バージョンがインストールされることから、追� のルートストレージが利用できなければなりません。 十分なルートディスクストレージがなければ、事前チェックで通知されます。
• ホットパッチでアップグレードする� �合、インスタンスの� 荷は高すぎてはなりません。もし� 荷が高すぎると、ホットパッチのプロセスに影響するかもしれません。
• GitHub Enterprise Server 2.17にアップグレードすると、監査ログがElasticsearchからMySQLに移行されます。 この移行により、スナップショットの復元に必要な時間とディスク容量も増� します。 移行の前に、次のコマンドでElasticsearch監査ログのインデックスでバイト数を確認してく� さい。

  curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes

  MySQLの監査ログで必要なディスク容量の概算には、この数字を使用します。 スクリプトは、インポートの進行中に空きディスク容量も監視します。 この数字を監視しておくと、空きディスク容量が、移行に必要なディスク容量に近い� �合に特に便利です。

About minimum requirements for GitHub Enterprise Server 3.0 and later

Before upgrading to GitHub Enterprise Server 3.0 or later, review the hardware resources you've provisioned for your instance. GitHub Enterprise Server 3.0 introduces new features such as GitHub Actions and GitHub Packages, and requires more resources than versions 2.22 and earlier. For more information, see the GitHub Enterprise Server 3.0 release notes.

Increased requirements for GitHub Enterprise Server 3.0 and later are bold in the following table.

User licenses	vCPUs	Memory	Attached storage	Root storage
Trial, demo, or 10 light users	4 Up from 2	32 GB Up from 16 GB	150 GB Up from 100 GB	200 GB
10 to 3,000	8 Up from 4	48 GB Up from 32 GB	300 GB Up from 250 GB	200 GB
3,000 to 5000	12 Up from 8	64 GB	500 GB	200 GB
5,000 to 8000	16 Up from 12	96 GB	750 GB	200 GB
8,000 to 10,000+	20 Up from 16	160 GB Up from 128 GB	1000 GB	200 GB

For more information about hardware requirements for GitHub Actions, see "Getting started with GitHub Actions for GitHub Enterprise Server."

既存のインスタンスのリソース調整に関する詳しい情� �については「ストレージ容量の増� 」及び「CPUあるいはメモリリソースの増� 」を参照してく� さい。

次のステップ

これらの推奨および要求事� �をレビューした後で、GitHub Enterprise Server をアップグレードできます。 詳細は「GitHub Enterprise Server をアップグレードする」を参照してく� さい。