Azure で GitHub Enterprise Server をインストールする

このガイドの内容

• 必要な環境
• ハードウェアについて
• 仮想マシンタイプの決定
• GitHub Enterprise Server 仮想マシンを作成する
• GitHub Enterprise Server 仮想マシンを設定する

GitHub Enterprise Server をグローバル Azure または Azure Government にデプロイできます。

必要な環境

• 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."

• 新しいコンピューターをプロビジョニングできる Azure アカウントを所有していなければなりません。 詳しい情報については Microsoft Azure のウェブサイトを参照してください。

• 仮想マシン（VM）を起動するのに必要なアクションのほとんどは、Azureポータルを使っても行えます。 とはいえ、初期セットアップ用にはAzureコマンドラインインターフェース（CLI）をインストールすることをお勧めします。 以下の例では、Azure CLI 2.0が使われています。 詳しい情報についてはAzureのガイドの"Azure CLI 2.0のインストール"を参照してください。

ハードウェアについて

GitHub Enterprise Server requires a persistent data disk separate from the root disk. For more information, see "System overview."

GitHub Enterprise Server インスタンスで使用するシート数に基づくハードウェア構成をおすすめします。 |

以下に最小の推奨構成を示します。 ユーザのアクティビティや他の製品との結合といった利用方法によっては、さらに多くのリソースが必要になることがあります。 詳しい情報については、「CPUあるいはメモリリソースの追加」を参照してください。

仮想マシンタイプの決定

GitHub Enterprise Server インスタンスをAzure上で起動する前に、組織の要求に最も適した仮想マシンのタイプを決定しなければなりません。

サポートされているVMタイプとリージョン

GitHub Enterprise Server アプライアンスは、プレミアムストレージのデータディスクを必要としており、プレミアムストレージをサポートするあらゆる Azure VM でサポートされます。 詳しい情報については、Azureドキュメンテーション中の"サポート対象のVM"を参照してください。 利用可能なVMに関する一般的な情報についてはAzure仮想マシンの概要ページを参照してください。

GitHub Enterprise Server は、VM タイプをサポートするあらゆる地域をサポートします。 各VMがサポートされるリージョンに関する詳しい情報については"リージョン別の利用可能な製品"を参照してください。

推奨VMタイプ

14 GB 以上の RAM を搭載した DS v2 インスタンスタイプを使用することをおすすめします。 サポートされているあらゆる VM タイプを使用できます。 シートに応じて、以下のインスタンスタイプをおすすめします。

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. 詳細は「ハードウェアについて」を参照してください。

1. 最新の GitHub Enterprise Server アプライアンスイメージを見つけます。 vm image list コマンドに関する詳しい情報については、Microsoftのドキュメンテーション中の"az vm image list"を参照してください。

   $ az vm image list --all -f GitHub-Enterprise | grep '"urn":' | sort -V

2. 見つけたアプライアンスイメージを使用して新しい VM を作成します。 For more information, see "az vm create" in the Microsoft documentation.

   VM の名前、リソースグループ、VM のサイズ、優先する Azure リージョンの名前、前の手順でリストしたアプライアンスイメージ VM の名前、およびプレミアムストレージ用のストレージ SKU についてのオプションを渡します。 For more information about resource groups, see "Resource groups" in the Microsoft documentation.

   $ az vm create -n VM_NAME -g RESOURCE_GROUP --size VM_SIZE -l REGION --image APPLIANCE_IMAGE_NAME --storage-sku Premium_LRS

3. 必要なポートを開くように VM でセキュリティを設定します。 For more information, see "az vm open-port" in the Microsoft documentation. どのポートを開く必要があるかを判断するための各ポートの説明については、以下の表を参照してください。

   $ az vm open-port -n VM_NAME -g RESOURCE_GROUP --port PORT_NUMBER

   This table identifies what each port is used for.

   ポート	サービス	説明
   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プロトコルのポートです。 パブリックリポジトリのクローンとフェッチのみができます。 暗号化されていないネットワーク通信です。

4. 新しい暗号化されていないデータディスクを作成してVMにアタッチし、シート数に基づいてサイズを調整してください。 For more information, see "az vm disk attach" in the Microsoft documentation.

   Pass in options for the name of your VM (for example, ghe-acme-corp), the resource group, the premium storage SKU, the size of the disk (for example, 100), and a name for the resulting VHD.

   $ az vm disk attach --vm-name VM_NAME -g RESOURCE_GROUP --sku Premium_LRS --new -z SIZE_IN_GB --disk ghe-data.vhd

   Note: For non-production instances to have sufficient I/O throughput, the recommended minimum disk size is 40 GiB with read/write cache enabled (--caching ReadWrite).

GitHub Enterprise Server 仮想マシンを設定する

1. VM を設定する前に、VMがReadyRole ステータスになるのを待つ必要があります。 Check the status of the VM with the vm list command. For more information, see "az vm list" in the Microsoft documentation.

   $ az vm list -d -g RESOURCE_GROUP -o table
   > Name    ResourceGroup    PowerState    PublicIps     Fqdns    Location    Zones
   > ------  ---------------  ------------  ------------  -------  ----------  -------
   > VM_NAME RESOURCE_GROUP   VM running    40.76.79.202           eastus

   メモ: Azure は VM 用の FQDN エントリを自動的に作成しません。 詳しい情報については、"Linux VM用Azure Portalでの完全修飾ドメイン名の作成" 方法に関する Azure のガイドを参照してください。

2. Copy the virtual machine's public DNS name, and paste it into a web browser.

3. At the prompt, upload your license file and set a management console password. For more information, see "Managing your GitHub Enterprise Server license."

4. In the Management Console, configure and save your desired settings. For more information, see "Configuring the GitHub Enterprise Server appliance."

5. The instance will restart automatically.

6. Click Visit your instance.

参考リンク

• "システムの概要"