ノート:
- Features such as GitHub Actions, GitHub Packages, GitHub Mobile and GitHub Advanced Security are available on GitHub Enterprise Server 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements.
- サポートされているバージョンについては、アップグレードパッケージが enterprise.github.com から利用できます。 アップグレードを完了するには、必要なアップグレードパッケージが利用できることを確認してく� さい。 パッケージが利用できない� �合はGitHub Enterprise Supportに連絡して支援を求めてく� さい。
- GitHub Enterprise Server クラスタリングを利用している� �合は、クラスタリングに固有の手� �については GitHub Enterprise Server クラスタリングガイド中の「クラスタをアップグレードする」を参照してく� さい。
- GitHub Enterprise Server のリリースノートには、GitHub Enterprise Server のすべてのバージョンの新機能の包括的なリストがあります。 詳しい情� �についてはリリースページを参照してく� さい。
推奨される対応
- アップグレードのプロセスに含めるアップグレードは、できる� け少なくしてく� さい。 たとえば 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監査ログのインデックスでバイト数を確認してく� さい。
MySQLの監査ログで必要なディスク容量の概算には、この数字を使用します。 スクリプトは、インポートの進行中に空きディスク容量も監視します。 この数字を監視しておくと、空きディスク容量が、移行に必要なディスク容量に近い� �合に特に便利です。curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes
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 をアップグレードする」を参照してく� さい。