OpenStack KVM で GitHub Enterprise Server をインストールする
GitHub Enterprise Server を OpenStack KVM 上にインストールするには、OpenStack にアクセスでき、GitHub Enterprise Server QCOW2 イメージをダウンロードすることが必要です。
このガイドの内容
- 必要な環境
- ハードウェアについて
- GitHub Enterprise Server イメージをダウンロードする
- GitHub Enterprise Server インスタンスを作成する
- GitHub Enterprise Server インスタンスを設定する
必要な環境
-
You must have a GitHub Enterprise license file. To download an existing license file or request a trial license, visit enterprise.github.com. For more information, see "Managing your GitHub Enterprise Server license."
-
OpenStackのサービス群へのWebベースのユーザインターフェースであるOpenStack Horizonの環境へのアクセスが必要です。 詳しい情報についてはHorizonのドキュメンテーションを参照してください。
ハードウェアについて
GitHub Enterprise Server requires a persistent data disk separate from the root disk. For more information, see "System overview."
ストレージデバイスには、高パフォーマンスの SSD を直接アタッチするか、ストレージエリアネットワーク (SAN) を経由するかの、いずれかをおすすめします。
GitHub Enterprise Server インスタンスで使用するシート数に基づくハードウェア構成をおすすめします。 |
シート数 | vCPUs | メモリ | アタッチされたストレージ | ルートストレージ |
---|---|---|---|---|
10-500 | 2 | 16 GB | 100 GB | 200 GB |
500-3000 | 4 | 32 GB | 250 GB | 200 GB |
3000-5000 | 8 | 64 GB | 500 GB | 200 GB |
5000-8000 | 12 | 72 GB | 750 GB | 200 GB |
8000-10000+ | 16 | 128 GB | 1000 GB | 200 GB |
以下に最小の推奨構成を示します。 ユーザのアクティビティや他の製品との結合といった利用方法によっては、さらに多くのリソースが必要になることがあります。 詳しい情報については、「CPUあるいはメモリリソースの追加」を参照してください。
Note: The root disk can be resized by building a new appliance or using an existing appliance. For more information, see "Increasing storage capacity."
Warning: We recommend you use webhooks to fetch repository changes for continuous integration (CI) or similar systems. Regular automatic checks, or polling, will significantly reduce the scalability of your instance. For more information, see "About webhooks"
GitHub Enterprise Server イメージをダウンロードする
-
Navigate to the GitHub Enterprise Server download page.
-
ライセンスファイルをダウンロードするにはDownload license(ライセンスのダウンロード)をクリックしてください。
-
Click Get the latest release of GitHub Enterprise Server.
-
GitHubオンプレミスを選択し、続いてOpenStack KVM (QCOW2)をクリックしてください。
-
Download for OpenStack KVM (QCOW2)をクリックしてください。
GitHub Enterprise Server インスタンスを作成する
To create the instance, you'll need to import the GitHub Enterprise Server image to your virtual machine and attach an additional storage volume for your instance data. 詳細は「ハードウェアについて」を参照してください。
-
OpenStack Horizon で、ダウンロードした GitHub Enterprise Server のイメージをアップロードします。 その方法についてはOpenStackのガイド"Upload and manage images"の"Upload an image"セクションを参照してください。
-
Create a new virtual disk to use as an attached storage volume for your instance data, and configure the size based on your seat count. その方法についてはOpenStackのガイド"Create and manage volumes"を参照してください。
-
セキュリティグループを作成し、下の表の各ポートについて新しいセキュリティグループルールを追加してください。 その方法についてはOpenStackのガイド"Configure access and security for instances"を参照してください。
ポート サービス 説明 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プロトコルのポートです。 パブリックリポジトリのクローンとフェッチのみができます。 暗号化されていないネットワーク通信です。 -
フローティングIPをインスタンスに関連づけることもできます。 使用しているOpenStackのセットアップによっては、フローティングIPをプロジェクトに割り当て、それをインスタンスに関連づける必要があるかもしれません、 そうする必要があるかどうかは、システム管理者に連絡を取って判断してください。 詳しい情報については、OpenStackのドキュメンテーション中の"Allocate a floating IP address to an instance"を参照してください。
-
これまでのステップで作成したイメージ、データボリューム、セキュリティグループを使ってGitHub Enterprise Server インスタンスを起動してください。 その方法についてはOpenStackのガイド"Launch and manage instances"を参照してください。
GitHub Enterprise Server インスタンスを設定する
-
Copy the virtual machine's public DNS name, and paste it into a web browser.
-
At the prompt, upload your license file and set a management console password. For more information, see "Managing your GitHub Enterprise Server license."
-
In the Management Console, configure and save your desired settings. For more information, see "Configuring the GitHub Enterprise Server appliance."
-
The instance will restart automatically.
-
Click Visit your instance.
参考リンク
- "システムの概要"