前提条件
- GitHub Enterpriseのライセンスファイルを持っていなければなりません。 詳しくは、「GitHub Enterprise Server の試用版を設定する」と「GitHub Enterprise のライセンスについて」をご覧く� さい。
- Hyper-V をサポートしている Windows Server 2008 から Windows Server 2019 までを所有している必要があります。
- 仮想マシン (VM) の作成に必要なほとんどのアクションは、Hyper-V マネージャーを使用して実行することもできます。 とはいえ、初期セットアップのためにはWindows PowerShellコマンドラインシェルを使うことをおすすめします。 以下の例ではPowerShellを使っています。 詳細については、Windows PowerShell の概要に関する Microsoft ガイドを参照してく� さい。
ハードウェアに関する考慮事� �
最小要件
のユーザライセンス数に応じた様々なハードウェア構成をおすすめします。 最小要件以上のリソースを提供すれば、インスタンスのパフォーマンスとスケーラビリティは向上します。
ユーザー ライセンス | vCPU 数 | メモリ | ルート ストレージ | アタッチされた (データ) ストレージ |
---|---|---|---|---|
トライアル、デモ、あるいは10人の軽量ユーザ | 4 | 32 GB | 200 GB | 150 GB |
10-3000 | 8 | 48 GB | 200 GB | 300 GB |
3000-5000 | 12 | 64 GB | 200 GB | 500 GB |
5000-8000 | 16 | 96 GB | 200 GB | 750 GB |
8000-10000+ | 20 | 160 GB | 200 GB | 1000 GB |
インスタンスのユーザーに対して GitHub Actions を有効にする予定の� �合は、さらに多くのリソースが必要です。
vCPU 数 | メモリ | 最大コンカレンシー |
---|---|---|
8 | 64 GB | 300 ジョブ |
16 | 128 GB | 700 ジョブ |
32 | 160 GB | 1,300 ジョブ |
64 | 256 GB | 2,000 ジョブ |
96 | 384 GB | 4,000 ジョブ |
これらの要件の詳細については、「GitHub Enterprise Server の GitHub Actions の概要」を参照してく� さい。
既存のインスタンスのリソースの調整の詳細については、「ストレージ容量の増� 」および「CPU またはメモリ リソースの増� 」を参照してく� さい。
ストレージ
GitHub Enterprise Serverには、高い秒あたりの入出力操作(IOPS)と低いレイテンシを持つ高性能なSSDをおすすめします。 ワークロードはI/O集中的です。 ベアメタルのハイパーバイザを使用するなら、直接アタッチされたディスクか、ストレージエリアネットワーク(SAN)からのディスクを利用することをおすすめします。
インスタンスには、ルートディスクとは別の永続化用のデータディスクが必要です。 詳細については、「システ� の概要」をご覧く� さい。
GitHub Actions を構成するには、外部 BLOB ストレージを指定する必要があります。 詳細については、「GitHub Enterprise Server の GitHub Actions の概要」を参照してく� さい。
ルート ファイルシステ� 上の使用可能な� �域は、ディスクの合計サイズの 50% です。 新しいインスタンスを構築するか、既存のインスタンスを利用して、インスタンスのルートディスクのサイズを変更できます。 詳細については、「システ� の概要」および「ストレージ容量の増� 」を参照してく� さい。
CPU とメモリ
GitHub Enterprise Serverが必要とするCPU及びメモリリソースは、ユーザ、自動化、インテグレーションのアクティビティのレベルによります。
GitHub Enterprise Server インスタンスのユーザーに対して GitHub Actions を有効にする予定の� �合は、インスタンスに追� の CPU とメモリ リソースをプロビジョニングする必要がある� �合があります。 詳細については、「GitHub Enterprise Server の GitHub Actions の概要」を参照してく� さい。
CPUリソースを増やす� �合、インスタンスにプロビジョニングする各vCPUごとに少なくとも6.5GBのメモリを追� する(最大16vCPUまで)ことをおすすめします。 16以上のvCPUを使う� �合は、各vCPUごとに6.5GBのメモリを追� する必要はありませんが、インスタンスが十分なメモリを持っているかをモニターするべきです。
警告: GitHub Enterprise Server 上のアクティビティを外部システ� に通知する Webhook イベントを構成することをおすすめします。 変更の自動チェックまたは ポーリング は、インスタンスのパフォーマンスとスケーラビリティに悪影響を与えます。 詳細については、「Webhook について」を参照してく� さい。
GitHub Enterprise Server の容量とパフォーマンスの監視の詳細については、「アプライアンスを監視する」を参照してく� さい。
インスタンスのCPUあるいはメモリリソースは増やすことができます。 詳細については、「CPU またはメモリ リソースの増� 」を参照してく� さい。
GitHub Enterprise Server イメージをダウンロードする
-
ライセンスをダウンロードします。 詳細については、GitHub Enterprise のライセンスのダウンロード」を参照してく� さい。 1. 新しいインスタンスに使用するイメージに移動します。
- [リリース ノート]に移動します。
- 右側のサイドバーで、ダウンロードするバージョンをクリックします。
- [GitHub Enterprise Server X.X.X のダウンロード] をクリックします。
-
[GitHub オンプレミス] で、[ハイパーバイザーの選択] ドロップダウン メニューを選び、 [Hyper-V (VHD)] をクリックします。
-
[Hyper-V (VHD) のダウンロード] をクリックします。
GitHub Enterprise Server インスタンスを作成する
インスタンスを作成するには、GitHub Enterprise Server のイメージを仮想マシンにインポートし、インスタンスのデータ用に追� のストレージボリュー� をアタッチしなければなりません。 詳細については、「ハードウェアに関する考慮事� �」を参照してく� さい。
- PowerShell で、新しい第1世代の仮想マシンを作成し、ユーザライセンス数に基づいてサイズを設定し、ダウンロードしたGitHub Enterprise Serverイメージをアタッチします。 詳細については、Microsoft のドキュメントの「New-VM」を参照してく� さい。
PS C:\> New-VM -Generation 1 -Name VM_NAME -MemoryStartupBytes MEMORY_SIZE -BootDevice VHD -VHDPath PATH_TO_VHD
- インスタンスデータ用にアタッチされるストレージボリュー� として使うための新しい仮想ディスクを作成し、サイズをユーザライセンス数に基づいて設定してく� さい。
PATH_TO_DATA_DISK
をディスクを作成した� �所へのパスに置き換えます。 詳細については、Microsoft のドキュメントの「New-VHD」を参照してく� さい。PS C:\> New-VHD -Path PATH_TO_DATA_DISK -SizeBytes DISK_SIZE
- データディスクをインスタンスにアタッチします。 詳細については、Microsoft のドキュメントの「Add-VMHardDiskDrive」を参照してく� さい。
PS C:\> Add-VMHardDiskDrive -VMName VM_NAME -Path PATH_TO_DATA_DISK
- VM を起動します。 詳細については、Microsoft のドキュメントの「Start-VM」を参照してく� さい。
PS C:\> Start-VM -Name VM_NAME
- VM の IP アドレスを入手します。 詳細については、Microsoft のドキュメントの「Get-VMNetworkAdapter」を参照してく� さい。
PS C:\> (Get-VMNetworkAdapter -VMName VM_NAME).IpAddresses
- VM の IP アドレスをコピーし、Web ブラウザに貼り付けます。
GitHub Enterprise Server インスタンスを設定する
- 仮想マシンのパブリックDNS名をコピーして、Webブラウザに貼り付けてく� さい。 2. プロンプトでライセンスファイルをアップロードし、管理コンソールのパスワードを設定してく� さい。 詳細については、「GitHub Enterprise のライセンスの管理」を参照してく� さい。 3. [Management Console] で、目的の設定を構成して保存します。 詳細については、GitHub Enterprise Server アプライアンスの構成に関するページを参照してく� さい。
- インスタンスは自動的に再起動します。 1. [Visit your instance](インスタンスにアクセスする) をクリックします。