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

Hyper-V で GitHub Enterprise Server をインストールする

GitHub Enterprise Server を Hyper-V にインストールするには、Windows Server 2008 から Windows Server 2016 までを実行しているマシンに配備する必要があります。

ここには以下の内容があります:

必要な環境

  • GitHub Enterpriseのライセンスファイルを持っていなければなりません。 既存のライセンスファイルをダウンロードするか、トライアルライセンスをリクエストするには、enterprise.github.comにアクセスしてください。 詳しい情報については「GitHub Enterpriseライセンスの管理」を参照してください。
  • Hyper-VをサポートしているWindows Server 2008からWindows Server 2016を持っている必要があります。
  • 仮想マシン(VM)の作成に必要なほとんどのアクションは、 Hyper-V Managerを使っても行えます。 とはいえ、初期セットアップのためにはWindows PowerShellコマンドラインシェルを使うことをおすすめします。 以下の例ではPowerShellを使っています。 For more information, see the Microsoft guide "Getting Started with Windows PowerShell."

ハードウェアについて

Minimum requirements

We recommend different hardware configurations depending on the number of user licenses for your GitHub Enterprise Server instance. If you provision more resources than the minimum requirements, your instance will perform and scale better.

Note: If you enable beta features for GitHub Enterprise Server 2.22, your instance requires additional hardware resources. Minimum requirements for an instance with beta features enabled are bold in the following table. For more information about the features in beta, see "Beta features in GitHub Enterprise Server 2.22."

|
ユーザライセンスvCPUsメモリアタッチされたストレージルートストレージ
トライアル、デモ、あるいは10人の軽量ユーザ2
or 4
16 GB
or 32 GB
100 GB
or 150 GB
200 GB
10-30004
or 8
32 GB
or 48 GB
250 GB
or 300 GB
200 GB
3000-50008
or 12
64 GB500 GB200 GB
5000-800012
or 16
96 GB750 GB200 GB
8000-10000+16
or 20
128 GB
or 160 GB
1000 GB200 GB

For more information about adjusting resources for an existing instance, see "Increasing storage capacity" and "Increasing CPU or memory resources."

Beta features in GitHub Enterprise Server 2.22

You can sign up for beta features available in GitHub Enterprise Server 2.22 such as GitHub Actions, GitHub Packages, and code scanning. For more information, see the release notes for the 2.22 series on the GitHub Enterprise website.

If you enable beta features for GitHub Enterprise Server 2.22, your instance requires additional hardware resources. For more information, see "Minimum requirements".

If you enable the beta for GitHub Actions, review the following requirements and recommendations.

  • You must configure at least one runner for GitHub Actions workflows. 詳しい情報については「セルフホストランナーについて」を参照してください。

  • You must configure external blob storage. 詳しい情報については、「GitHub Actions の有効化とストレージの設定」をご覧ください。

  • You may need to configure additional CPU and memory resources. The additional resources you need to provision for GitHub Actions depend on the number of workflows your users run concurrently, and the overall levels of activity for users, automations, and integrations.

    Maximum jobs per minuteAdditional vCPUsAdditional memory
    Light testing430.5 GB
    25861 GB
    3516122 GB
    10032244 GB

ストレージ

We recommend a high-performance SSD with high input/output operations per second (IOPS) and low latency for GitHub Enterprise Server. Workloads are I/O intensive. If you use a bare metal hypervisor, we recommend directly attaching the disk or using a disk from a storage area network (SAN).

Your instance requires a persistent data disk separate from the root disk. 詳しい情報については「システムの概要」を参照してください。

If you enable the beta of GitHub Actions in GitHub Enterprise Server 2.22, you'll need to configure external blob storage. 詳しい情報については、「GitHub Actions の有効化とストレージの設定」をご覧ください。

You can resize your instance's root disk by building a new instance or using an existing instance. 詳しい情報については「ストレージ容量の増加」を参照してください。

CPU and memory

GitHub Enterprise Server requires more CPU and memory resources depending on levels of activity for users, automations, and integrations.

When you increase CPU resources, we recommend adding at least 6.5 GB of memory for each vCPU (up to 16 vCPUs) that you provision for the instance. When you use more than 16 vCPUs, you don't need to add 6.5 GB of memory for each vCPU, but you should monitor your instance to ensure it has enough memory.

Warning: We recommend that users configure webhook events to notify external systems of activity on GitHub Enterprise Server. Automated checks for changes, or polling, will negatively impact the performance and scalability of your instance. For more information, see "About webhooks."

You can increase your instance's CPU or memory resources. For more information, see "Increasing CPU or memory resources.

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. インスタンスデータ用にアタッチされるストレージボリュームとして使うための新しい仮想ディスクを作成し、サイズをユーザライセンス数に基づいて設定してください。 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ライセンスの管理」を参照してください。
  3. Management Consoleで、希望する設定を行って保存してください。詳しい情報については、「GitHub Enterprise Server アプライアンスを設定する」を参照してください。
  4. インスタンスは自動的に再起動します。
  5. Visit your instance(インスタンスへのアクセス)をクリックしてください。

参考リンク

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.