OpenStack KVM で GitHub Enterprise Server をインストールする

前提条件

GitHub Enterpriseのライセンスファイルを持っていなければなりません。詳細については、「GitHub Enterprise Server のトライアルを設定する」および「GitHub Enterpriseのライセンスについて」を参照してください。
OpenStackのサービス群へのWebベースのユーザインターフェースであるOpenStack Horizonの環境へのアクセスが必要です。詳細については、Horizon アクションのドキュメントを参照してください。

ハードウェアに関する考慮事項

最小要件
Storage
CPU とメモリ

最小要件

お使いの GitHub Enterprise Server インスタンスのユーザーライセンス数に応じた様々なハードウェア構成をおすすめします。最小要件以上のリソースを提供すれば、インスタンスのパフォーマンスとスケーラビリティは向上します。

ユーザーライセンス	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	740 ジョブ
16	128 GB	1,250 ジョブ
32	160 GB	2,700 ジョブ
64	256 GB	4,500 ジョブ
96	384 GB	7,000 ジョブ

これらの要件について詳しくは、「GitHub Enterprise Server の GitHub Actions を使い始める」をご覧ください。

インスタンスのユーザーに対して Container registry を有効にする予定の場合は、さらに多くのリソースが必要です。これらの要件について詳しくは、「Enterprise 向けの GitHub Packages を使い始める」をご覧ください。

既存インスタンスのリソース調整の詳細については、「ストレージ容量の増加」と「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 オンプレミス]で、[ハイパーバイザーの選択] ドロップダウンメニューを選択し、[ **OpenStack KVM (QCOW2)]** をクリックします。
[OpenStack KVM (QCOW2) のダウンロード] をクリックします。

GitHub Enterprise Server インスタンスを作成する

インスタンスを作成するには、GitHub Enterprise Server のイメージを仮想マシンにインポートし、インスタンスのデータ用に追加のストレージボリュームをアタッチしなければなりません。詳細については、「ハードウェアに関する考慮事項」を参照してください。

OpenStack Horizon で、ダウンロードした GitHub Enterprise Server のイメージをアップロードします。手順については、OpenStack ガイド「イメージのアップロードと管理」の「イメージのアップロードと管理」セクションを参照してください。
インスタンスデータ用にアタッチされるストレージボリュームとして使うための新しい仮想ディスクを作成し、サイズをユーザライセンス数に基づいて設定してください。手順については、OpenStack ガイド「ボリュームの作成と管理」を参照してください。

セキュリティグループを作成し、下の表の各ポートについて新しいセキュリティグループルールを追加してください。手順については、OpenStack ガイド「インスタンスのアクセスとセキュリティを構成する」を参照してください。

Port	サービス	説明
22	SSH	Git over SSHのアクセス。パブリック／プライベートリポジトリのクローン、フェッチ、プッシュ操作がサポートされています。
25	SMTP	暗号化（STARTTLS）付きのSMTPサポート。
80	HTTP	Webアプリケーションへのアクセス。 SSL が有効になっている場合、すべての要求は HTTPS ポートにリダイレクトされます。
122	SSH	インスタンスのシェルへのアクセス。既定の SSH ポート (22) は、アプリケーションの git+ssh ネットワークトラフィック専用です。
161/UDP	SNMP	ネットワークモニタリングプロトコルの処理に必要。
443	HTTPS	Webアプリケーション及びGit over HTTPSのアクセス。
1194/UDP	VPN	High Availability設定でのセキュアなレプリケーションネットワークトンネル。
8080	HTTP	プレーンテキストの Webベースの [Management Console]。 SSL を手動で無効にしない限り必要ありません。
8443	HTTPS	セキュアな Webベースの [Management Console]。基本的なインストールと設定に必要です。
9418	Git	シンプルなGitプロトコルのポートです。パブリックリポジトリのクローンとフェッチのみができます。暗号化されていないネットワーク通信。インスタンスでプライベートモードを有効化した場合、このポートをオープンする必要があるのは、匿名Git読み取りアクセスも有効化している場合のみです。詳しくは、「Enterprise でリポジトリ管理ポリシーを適用する」を参照してください。

フローティングIPをインスタンスに関連づけることもできます。使用しているOpenStackのセットアップによっては、フローティングIPをプロジェクトに割り当て、それをインスタンスに関連づける必要があるかもしれません、そうする必要があるかどうかは、システム管理者に連絡を取って判断してください。詳細については、OpenStack ドキュメントの「インスタンスへのフローティング IP アドレスの割り当て」を参照してください。
これまでの手順で作成したイメージ、データボリューム、セキュリティグループを使って、お使いの GitHub Enterprise Server インスタンスを起動します。手順については、OpenStack ガイド「インスタンスの起動と管理」を参照してください。

GitHub Enterprise Server インスタンスを設定する

仮想マシンのパブリックDNS名をコピーして、Webブラウザに貼り付けてください。 2. プロンプトでライセンスファイルをアップロードし、管理コンソールのパスワードを設定してください。詳しくは、「GitHub Enterpriseのライセンス管理」を参照してください。 3. [Management Console] で、目的の設定を構成して保存します。詳しくは、「Enterprise を設定する」をご覧ください。
インスタンスは自動的に再起動します。 1. [Visit your instance](インスタンスにアクセスする) をクリックします。