記事のバージョン： Enterprise Server 2.17
Hyper-V で GitHub Enterprise Server をインストールする
GitHub Enterprise Server を Hyper-V にインストールするには、Windows Server 2008 から Windows Server 2016 までを実行しているマシンに配備する必要があります。
必要な環境
- GitHub Enterpriseのライセンスファイルを持っていなければなりません。 既存のライセンスファイルをダウンロードするか、トライアルライセンスをリクエストするには、enterprise.github.comにアクセスしてください。 詳しい情報については「GitHub Enterprise Serverライセンスの管理」を参照してください。
- Hyper-VをサポートしているWindows Server 2008からWindows Server 2016を持っている必要があります。
- 仮想マシン（VM）の作成に必要なほとんどのアクションは、 Hyper-V Managerを使っても行えます。 とはいえ、初期セットアップのためにはWindows PowerShellコマンドラインシェルを使うことをおすすめします。 以下の例ではPowerShellを使っています。 詳しい情報については、Microsoftのガイド"Windows PowerShell ファースト ステップ ガイド"を参照してください。
ハードウェアについて
GitHub Enterprise Serverは、ルートディスクとは別に永続化用のデータディスクを必要とします。 詳しい情報については「システムの概要」を参照してください。 ストレージデバイスには、高パフォーマンスの SSD を直接アタッチするか、ストレージエリアネットワーク (SAN) を経由するかの、いずれかをおすすめします。 GitHub Enterprise Server インスタンスで使用するユーザライセンス数に基づくハードウェア構成をおすすめします。 |
| ユーザライセンス | vCPUs | メモリ | アタッチされたストレージ | ルートストレージ |
|---|---|---|---|---|
| トライアル、デモ、あるいは10人の軽量ユーザ | 2 | 16 GB | 100 GB | 200 GB |
| 10-3000 | 4 | 32 GB | 250 GB | 200 GB |
| 3000-5000 | 8 | 64 GB | 500 GB | 200 GB |
| 5000-8000 | 12 | 96 GB | 750 GB | 200 GB |
| 8000-10000+ | 16 | 128 GB | 1000 GB | 200 GB |
以下に最小の推奨構成を示します。 ユーザのアクティビティや他の製品との結合といった利用方法によっては、さらに多くのリソースが必要になることがあります。 CPUリソースを増加させる場合には、GitHub Enterprise Serverインスタンスに追加されるCPUごと（最大で16CPU）に少なくとも6.5GBのメモリを追加することをおすすめします。 詳しい情報については、「CPUあるいはメモリリソースの追加」を参照してください。
ノート：ルートディスクは、新しいアプライアンスを構築するか、既存のアプライアンスを利用してリサイズできます。 詳しい情報については「ストレージ容量の増加」を参照してください。
警告： 継続的インテグレーション（CI）あるいはそれに類したシステムでリポジトリの変更をフェッチするには、webhookの利用をおすすめします。 定期的な自動チェック、あるいはポーリングは、インスタンスのスケーラビリティを大きく損ないます。 詳しい情報については「webhookについて」を参照してください。
GitHub Enterprise Server イメージをダウンロードする
- GitHub Enterprise Serverのダウンロードページにアクセスしてください。
- ライセンスファイルをダウンロードするにはDownload license（ライセンスのダウンロード）をクリックしてください。
- Get the latest release of GitHub Enterprise Server (GitHub Enterprise Server の最新リリースを入手) をクリックします。
- GitHubオンプレミスを選択し、Hyper-V (VHD)をクリックしてください。
- Download for 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ブラウザに貼り付けてください。
- プロンプトでライセンスファイルをアップロードし、管理コンソールのパスワードを設定してください。 詳しい情報については「GitHub Enterprise Serverライセンスの管理」を参照してください。
- Management Consoleで、希望する設定を行って保存してください。詳しい情報については、「GitHub Enterprise Server アプライアンスを設定する」を参照してください。
- インスタンスは自動的に再起動します。
- Visit your instance（インスタンスへのアクセス）をクリックしてください。
参考リンク
- "システムの概要"