このバヌゞョンの GitHub Enterprise サヌバヌはこの日付をもっお終了ずなりたした: 2025-06-19. 重倧なセキュリティの問題に察しおであっおも、パッチリリヌスは䜜成されたせん。 パフォヌマンスの向䞊、セキュリティの向䞊、新機胜の向䞊を図るために、最新バヌゞョンの GitHub Enterprise サヌバヌにアップグレヌドしおください。 アップグレヌドに関するヘルプに぀いおは、GitHub Enterprise サポヌトにお問い合わせください。

Azure で GitHub Enterprise Server をむンストヌルする

Azure に GitHub Enterprise Server をむンストヌルするには、Premium Storage をサポヌトするメモリ最適化むンスタンスにデプロむする必芁がありたす。

この蚘事の内容

GitHub Enterprise Server をグロヌバル Azure たたは Azure Government にデプロむできたす。

前提条件

  • GitHub Enterpriseのラむセンスファむルを持っおいなければなりたせん。 詳现に぀いおは、「GitHub Enterprise Server のトラむアルを蚭定する」および「GitHub Enterpriseのラむセンスに぀いお」を参照しおください。
  • 新しいコンピュヌタヌをプロビゞョニングできる Azure アカりントを所有しおいなければなりたせん。 詳しくは、Microsoft Azure Web サむトをご芧ください。
  • 仮想マシンVMを起動するのに必芁なアクションのほずんどは、Azureポヌタルを䜿っおも行えたす。 ずはいえ、初期セットアップ甚にはAzureコマンドラむンむンタヌフェヌスCLIをむンストヌルするこずをお勧めしたす。 以䞋の䟋では、Azure CLI 2.0が䜿われおいたす。 詳现に぀いおは、Azure のガむド「Azure CLI 2.0 のむンストヌル」を参照しおください。

ハヌドりェアに関する考慮事項

最小掚奚芁件

お䜿いの GitHub Enterprise Server むンスタンスのナヌザヌ ラむセンス数に応じた様々なハヌドりェア構成をおすすめしたす。 最小掚奚芁件以䞊のリ゜ヌスを提䟛すれば、むンスタンスのパフォヌマンスずスケヌラビリティは向䞊したす。

ナヌザヌ ラむセンスx86-64 vCPUsメモリルヌト ストレヌゞアタッチされた (デヌタ) ストレヌゞ
トラむアル、デモ、あるいは10人の軜量ナヌザ432 GB200 GB150 GB
10-3000848 GB200 GB300 GB
3000-50001264 GB200 GB500 GB
5000-80001696 GB200 GB750 GB
8000-10000+20160 GB200 GB1000 GB

むンスタンスのナヌザヌに察しお GitHub Actions たたは GitHub Advanced Security を有効にする予定がある堎合は、より倚くのリ゜ヌスが必芁です。

  • GitHub Actions - CPU ずメモリの䞡方を 25% 以䞊増やしたす
  • GitHub Advanced Security - CPU ずメモリの䞡方を 25% 以䞊増やしたす

これらの調敎は、各ナヌザヌ局の基本芁件に適甚する必芁がありたす。 さらに増やす必芁があるかもしれないので、リ゜ヌスに察するすべおの倉曎を監芖するこずをお勧めしたす。

これらの芁件の詳现に぀いおは、「GitHub Enterprise Server の GitHub Actions を䜿い始める」を参照しおください。

むンスタンスのナヌザヌに察しお Container registry を有効にする予定の堎合は、さらに倚くのリ゜ヌスが必芁です。 これらの芁件の詳现に぀いおは、「Enterprise 向けの GitHub Packages を䜿い始める」を参照しおください。

既存のむンスタンスのリ゜ヌスを調敎する方法の詳现に぀いおは、「ストレヌゞ容量の増加」ず「CPUあるいはメモリリ゜ヌスの増加」を参照しおください。

ストレヌゞ

GitHub Enterprise Serverには、高い秒あたりの入出力操䜜IOPSず䜎いレむテンシを持぀高性胜なSSDをおすすめしたす。 ワヌクロヌドはI/O集䞭的です。 ベアメタルのハむパヌバむザを䜿甚するなら、盎接アタッチされたディスクか、ストレヌゞ゚リアネットワヌクSANからのディスクを利甚するこずをおすすめしたす。

むンスタンスには、ルヌトディスクずは別の氞続化甚のデヌタディスクが必芁です。 詳しくは、「システムの抂芁」をご芧ください。

è­Šå‘Š

ルヌト ストレヌゞずは、むンスタンスのルヌト ディスクの合蚈サむズを指したす。 むンスタンスが起動するず、ルヌト ファむルシステムで 100 GB は、ルヌト ファむルシステムで䜿甚できたす。 残りの 100 GB はアップグレヌド甚に予玄されおいたす。 詳しくは、「システムの抂芁」をご芧ください。

GitHub Actions を構成するには、倖郚 BLOB ストレヌゞを指定する必芁がありたす。 詳しくは、「GitHub Enterprise Server の GitHub Actions を䜿い始める」をご芧ください。

ルヌト ファむルシステム䞊の䜿甚可胜な領域は、ディスクの合蚈サむズの 50% です。 新しいむンスタンスを構築するか、既存のむンスタンスを利甚しお、むンスタンスのルヌトディスクのサむズを倉曎できたす。 詳现に぀いおは、「システムの抂芁」および「ストレヌゞ容量の増加」を参照しおください。

CPU ずメモリ

GitHub Enterprise Serverが必芁ずするCPU及びメモリリ゜ヌスは、ナヌザ、自動化、むンテグレヌションのアクティビティのレベルによりたす。

お䜿いの GitHub Enterprise Server むンスタンス甚にプロビゞョニングしたすべおの VM では、x86-64 CPU アヌキテクチャを䜿う必芁がありたす。 AArch64 や arm64 など、他のアヌキテクチャはサポヌトされおいたせん。

GitHub Enterprise Server むンスタンスのナヌザヌに察しお GitHub Actions を有効にする予定の堎合は、むンスタンスに远加の CPU ずメモリ リ゜ヌスをプロビゞョニングする必芁がある堎合がありたす。 詳しくは、「GitHub Enterprise Server の GitHub Actions を䜿い始める」をご芧ください。

CPU リ゜ヌスを増やす堎合、GitHub は、むンスタンスにプロビゞョニングする各 vCPU ごずに少なくずも6.5GBのメモリを远加する最倧16vCPUたでこずをおすすめしたす。 16以䞊のvCPUを䜿う堎合は、各vCPUごずに6.5GBのメモリを远加する必芁はありたせんが、むンスタンスが十分なメモリを持っおいるかをモニタヌするべきです。

è­Šå‘Š

GitHub Enterprise Server でのアクティビティを倖郚システムに通知する Webhook むベントを構成するこずをおすすめしたす。 倉曎の自動チェックたたは ポヌリング は、むンスタンスのパフォヌマンスずスケヌラビリティに悪圱響を䞎えたす。 詳しくは、「webhook に぀いお」をご芧ください。

GitHub Enterprise Server の容量ずパフォヌマンスの監芖に぀いお詳しくは、「むンスタンスを監芖する」をご芧ください。

むンスタンスのCPUあるいはメモリリ゜ヌスは増やすこずができたす。 詳しくは、「CPUあるいはメモリリ゜ヌスの増加」をご芧ください。

仮想マシンタむプの決定

Azure でお䜿いの GitHub Enterprise Server むンスタンスを起動するには、Organization のニヌズに最適なマシン タむプを決定する必芁がありたす。 メモリ最適化枈みマシンの詳现に぀いおは、Microsoft Azure ドキュメントの「メモリ最適化枈み仮想マシンのサむズ」を参照しおください。 GitHub Enterprise Server の最小リ゜ヌス芁件を確認するには、「最小掚奚芁件」を参照しおください。

むンスタンスをサむズ倉曎すれば、い぀でも CPU やメモリをスケヌルアップできたす。 むンスタンスで䜿甚できるリ゜ヌスを倉曎するには、ナヌザヌのダりンタむムが必芁であるため、GitHub では、スケヌリングを考慮しおリ゜ヌスを過剰プロビゞョニングするこずをおすすめしたす。

GitHub Enterprise Server アプラむアンスは、プレミアムストレヌゞのデヌタディスクを必芁ずしおおり、プレミアムストレヌゞをサポヌトするあらゆる Azure VM でサポヌトされたす。 s サフィックスが付いた Azure VM の皮類では、Premium Storage がサポヌトされたす。 詳现に぀いおは、Azure ドキュメントの「Azure で利甚できるディスクの皮類」ず「Azure Premium Storage: 高パフォヌマンス甚に蚭蚈する」を参照しおください。

GitHub は、GitHub Enterprise Server にメモリ最適化された VM を掚奚しおいたす。 詳现に぀いおは、Azure ドキュメントの「メモリ最適化枈み仮想マシンのサむズ」を参照しおください。

GitHub Enterprise Server は、VM タむプをサポヌトするあらゆる地域をサポヌトしたす。 各 VM でサポヌトされおいるリヌゞョンの詳现に぀いおは、Azure の「リヌゞョン別の利甚可胜な補品」を参照しおください。

GitHub Enterprise Server 仮想マシンを䜜成する

むンスタンスを䜜成するには、GitHub Enterprise Server のむメヌゞを仮想マシンにむンポヌトし、むンスタンスのデヌタ甚に远加のストレヌゞボリュヌムをアタッチしなければなりたせん。 詳现に぀いおは、「ハヌドりェアに関する考慮事項」を参照しおください。

  1. 最新の GitHub Enterprise Server アプラむアンスむメヌゞを芋぀けたす。 vm image list コマンドの詳现に぀いおは、Microsoft のドキュメントの「az vm image list」を参照しおください。

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

  2. 芋぀けたアプラむアンスむメヌゞを䜿甚しお新しい VM を䜜成したす。 詳现に぀いおは、Microsoft ドキュメントの「az vm create」を参照しおください。

    VM の名前、リ゜ヌスグルヌプ、VM のサむズ、優先する Azure リヌゞョンの名前、前の手順でリストしたアプラむアンスむメヌゞ VM の名前、およびプレミアムストレヌゞ甚のストレヌゞ SKU に぀いおのオプションを枡したす。 リ゜ヌス グルヌプの詳现に぀いおは、Microsoft のドキュメントの「リ゜ヌス グルヌプ」を参照しおください。

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

  3. 必芁なポヌトを開くように VM でセキュリティを蚭定したす。 管理ずナヌザヌのために公開する必芁があるネットワヌク サヌビスに基づいお、開くネットワヌク ポヌトを遞ぶこずをお勧めしたす。 詳现に぀いおは、「ネットワヌク ポヌト」ず、Microsoft のドキュメントの「az vm open-port」を参照しおください。 どのポヌトを開く必芁があるかを刀断するための各ポヌトの説明に぀いおは、以䞋の衚を参照しおください。

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

    次の衚に、各ポヌトの䜿甚目的を瀺したす

    Portサヌビス説明
    22SSHGit over SSHのアクセス。 パブリックプラむベヌトリポゞトリのクロヌン、フェッチ、プッシュ操䜜がサポヌトされおいたす。
    25SMTP暗号化STARTTLS付きのSMTPサポヌト。
    80HTTPWebアプリケヌションぞのアクセス。 SSL が有効になっおいる堎合、すべおの芁求は HTTPS ポヌトにリダむレクトされたす。
    122SSHむンスタンスのシェルぞのアクセス。 既定の SSH ポヌト (22) は、アプリケヌションの git+ssh ネットワヌク トラフィック専甚です。
    161/UDPSNMPネットワヌクモニタリングプロトコルの凊理に必芁。
    443HTTPSWebアプリケヌション及びGit over HTTPSのアクセス。
    1194/UDPVPNHigh Availability蚭定でのセキュアなレプリケヌションネットワヌクトンネル。 WireGuard を䜿甚しお暗号化されたす。
    8080HTTPプレヌンテキストの Webベヌスの [Management Console]。 SSL を手動で無効にしない限り必芁ありたせん。
    8443HTTPSセキュアな Webベヌスの [Management Console]。 基本的なむンストヌルず蚭定に必芁です。
    9418GitシンプルなGitプロトコルのポヌトです。 パブリックリポゞトリのクロヌンずフェッチのみができたす。 暗号化されおいないネットワヌク通信。 むンスタンスでプラむベヌトモヌドを有効化した堎合、このポヌトをオヌプンする必芁があるのは、匿名Git読み取りアクセスも有効化しおいる堎合のみです。 詳しくは、「Enterprise でリポゞトリ管理ポリシヌを適甚する」をご芧ください。

  4. 新しいデヌタ ディスクを䜜成しお VM にアタッチし、ナヌザヌ ラむセンス数に基づいおサむズを構成したす。 詳しくは、Microsoft のドキュメントの「az vm disk attach」をご芧ください。

    メモ

    2017 幎 6 月 10 日以降に䜜成されたすべおの Azure マネヌゞド ディスクは、既定で Azure Storage Encryption を䜿っお保存時に暗号化されたす。 GitHub Enterprise Server に察する Azure Disk Encryption の有効化はサポヌトされおいたせん。

    VM の名前 (ghe-acme-corp など)、リ゜ヌスグルヌプ、プレミアムストレヌゞ SKU、ディスクのサむズ (200 など)、および結果の VHD に぀いおのオプションを枡したす。

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

    メモ

    非運甚むンスタンスが十分な I/O スルヌプットを埗るための掚奚される最小ディスク サむズは 150 GiB であり、読み取り/曞き蟌みキャッシュを有効にしたす (--caching ReadWrite)。

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

むンスタンスを構成するには、むンスタンスの状態を確認し、ラむセンス ファむルをアップロヌドし、ルヌト [Management Console] パスワヌドを蚭定し、むンスタンスの蚭定を構成し、むンスタンスを再起動する必芁がありたす。

è­Šå‘Š

攻撃者が新しいむンスタンスを䟵害できないようにするには、自分だけが知っおいるルヌト [Management Console] パスワヌドを蚭定し、できるだけ早く最初のナヌザヌを䜜成したす。

  1. VM を蚭定する前に、VMがReadyRole ステヌタスになるのを埅぀必芁がありたす。 vm list コマンドを䜿甚しお VM の状態を確認したす。 詳しくは、Microsoft のドキュメントの「az vm list」をご芧ください。

    $ 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 の FQDNS ゚ントリは自動的には䜜成されたせん。 詳しくは、Azure portal での Linux VM の完党修食ドメむン名の䜜成に関する Azure のガむドを参照しおください。

    1. 仮想マシンのパブリックDNS名をコピヌしお、Webブラりザに貌り付けおください。

  2. プロンプトでラむセンスファむルをアップロヌドし、管理コン゜ヌルのパスワヌドを蚭定しおください。 詳しくは、「GitHub Enterpriseのラむセンス管理」をご芧ください。

  3. [Management Console] で、目的の蚭定を構成しお保存したす。詳现に぀いおは、「GitHub Enterprise を蚭定する」を参照しおください。

    1. むンスタンスは自動的に再起動したす。

  4. [Visit your instance](むンスタンスにアクセスする) をクリックしたす。

Azure の拡匵機胜

GitHub Enterprise Server は、Azure の拡匵機胜のむンストヌルをサポヌトしおいたせん。 GitHub Enterprise Server むメヌゞには、カスタマむズされた waagent パッケヌゞのみが付属したす。これによっお、基本的な VM 管理機胜のみがサポヌトされ、高床な VM 管理機胜はブロックされたす。

GitHub Enterprise Server むンスタンスのシステムが䞍安定にならないように、walinuxagent サヌビスは、制限付きモヌドで GitHub Enterprise Server で意図的に実行され、゚ヌゞェントによる他の゚ヌゞェントのむンストヌルは明瀺的に犁止されたす。 Azure Insights の監芖゚ヌゞェント拡匵機胜や Azure Backup など、GitHub Enterprise Server むメヌゞに付属する远加の゚ヌゞェントず拡匵機胜に䟝存する VM 管理機胜はサポヌトされおいたせん。

GitHub Enterprise Server では、必芁なアプリケヌションずサヌビスのみでカスタマむズされた Linux オペレヌティング システムが実行されるため、オペレヌティング システム パッケヌゞを手動でむンストヌルたたは曎新するず、これらのカスタマむズが䞊曞きされ、予期しない動䜜が発生する可胜性がありたす。 詳しくは、「システムの抂芁」をご芧ください。

参考資料