Hyper-V で GitHub Enterprise Server をインストールする
GitHub Enterprise Server を Hyper-V にインストールするには、Windows Server 2008 から Windows Server 2016 までを実行しているマシンに配備する必要があります。
このガイドの内容
- 必要な環境
- ハードウェアについて
- 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."
-
Hyper-VをサポートしているWindows Server 2008からWindows Server 2016を持っている必要があります。
-
仮想マシン（VM）の作成に必要なほとんどのアクションは、 Hyper-V Managerを使っても行えます。 とはいえ、初期セットアップのためにはWindows PowerShellコマンドラインシェルを使うことをおすすめします。 以下の例ではPowerShellを使っています。 詳しい情報については、Microsoftのガイド"Windows PowerShell ファースト ステップ ガイド"を参照してください。
ハードウェアについて
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オンプレミスを選択し、Hyper-V (VHD)をクリックしてください。
-
Download for Hyper-V (VHD)をクリックしてください。
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. 詳細は「ハードウェアについて」を参照してください。
-
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 -
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.
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 インスタンスを設定する
-
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.
参考リンク
- "システムの概要"