ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。
記事のバージョン: Enterprise Server 2.18

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) を経由するかの、いずれかをおすすめします。 We recommend different hardware configurations based on the number of user licenses used in GitHub Enterprise Server インスタンス. |

ユーザライセンスvCPUsメモリアタッチされたストレージルートストレージ
トライアル、デモ、あるいは10人の軽量ユーザ216 GB100 GB200 GB
10-3000432 GB250 GB200 GB
3000-5000864 GB500 GB200 GB
5000-80001296 GB750 GB200 GB
8000-10000+16128 GB1000 GB200 GB

以下に最小の推奨構成を示します。 ユーザのアクティビティや他の製品との結合といった利用方法によっては、さらに多くのリソースが必要になることがあります。 When increasing CPU resources, it's recommended to add at least 6.5 GB of memory for each CPU (up to 16 CPUs) added to your GitHub Enterprise Server instance. 詳しい情報については、「CPUあるいはメモリリソースの追加」を参照してください。

ノート:ルートディスクは、新しいアプライアンスを構築するか、既存のアプライアンスを利用してリサイズできます。 詳しい情報については「ストレージ容量の増加」を参照してください。

警告: 継続的インテグレーション(CI)あるいはそれに類したシステムでリポジトリの変更をフェッチするには、webhookの利用をおすすめします。 定期的な自動チェック、あるいはポーリングは、インスタンスのスケーラビリティを大きく損ないます。 詳しい情報については「webhookについて」を参照してください。

GitHub Enterprise Server イメージをダウンロードする

  1. GitHub Enterprise Serverのダウンロードページにアクセスしてください。
  2. ライセンスファイルをダウンロードするにはDownload license(ライセンスのダウンロード)をクリックしてください。
  3. Get the latest release of GitHub Enterprise Server (GitHub Enterprise Server の最新リリースを入手) をクリックします。
  4. GitHubオンプレミスを選択し、Hyper-V (VHD)をクリックしてください。
  5. Download for Hyper-V (VHD)をクリックしてください。

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

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

  1. 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  
  2. Create a new virtual disk to use as an attached storage volume for your instance data, and configure the size based on your user license count. PATH_TO_DATA_DISK をディスクを作成した場所へのパスに置き換えます。 詳しい情報については、Microsoft ドキュメンテーションの「New-VHD」を参照してください。
    PS C:\> New-VHD -Path PATH_TO_DATA_DISK -SizeBytes DISK_SIZE
  3. データディスクをインスタンスにアタッチします。 詳しい情報については、Microsoftドキュメンテーションの「Add-VMHardDiskDrive」を参照してください。
    PS C:\> Add-VMHardDiskDrive -VMName VM_NAME -Path PATH_TO_DATA_DISK
  4. VM を起動します。 詳しい情報については、Microsoftドキュメンテーションの「Start-VM」を参照してください。
    PS C:\> Start-VM -Name VM_NAME
  5. VM の IP アドレスを入手します。 詳しい情報については、Microsoftドキュメンテーションの「Get-VMNetworkAdapter」を参照してください。
    PS C:\> (Get-VMNetworkAdapter -VMName VM_NAME).IpAddresses
  6. VM の IP アドレスをコピーし、Web ブラウザに貼り付けます。

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

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

参考リンク

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください