OpenStack KVM GitHub Enterprise Server のインストール

前提条件

GitHub Enterpriseのライセンスファイルを持っていなければなりません。詳細については、「GitHub Enterprise Server の試用版の設定」および「GitHub Enterprise Server のライセンスファイル」を参照してください。
OpenStackのサービス群へのWebベースのユーザインターフェースであるOpenStack Horizonの環境へのアクセスが必要です。詳細については、Horizon アクションのドキュメントを参照してください。

ハードウェアに関する考慮事項

データ使い回し可能な.エンタープライズインストール.ハードウェア考慮事項-全プラットフォーム %}

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

ライセンスをダウンロードします。詳しくは、「GitHub Enterprise のライセンスのダウンロード」をご覧ください。1. 新しいインスタンスに使用するイメージに移動します。
- [リリースノート]に移動します。
- 右側のサイドバーで、ダウンロードするバージョンをクリックします。
- [GitHub Enterprise Server X.X.X のダウンロード] をクリックします。
[GitHub オンプレミス]で、[ハイパーバイザーの選択] ドロップダウンメニューを選択し、[ OpenStack KVM (QCOW2)] をクリックします。

       **[OpenStack KVM (QCOW2) のダウンロード]** をクリックします。

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

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

OpenStack Horizon で、ダウンロードした GitHub Enterprise Server のイメージをアップロードします。手順については、OpenStack ガイド「Upload and manage images (イメージのアップロードと管理)」の「Upload an image (イメージのアップロード)」セクションを参照してください。
インスタンスデータ用にアタッチされるストレージボリュームとして使うための新しい仮想ディスクを作成し、サイズをユーザライセンス数に基づいて設定してください。既存のディスクを再利用する場合は、ディスクが空であり、パーティションが存在しないことを確認してください。手順については、OpenStack ガイド「Create and manage volumes」(ボリュームの作成と管理) を参照してください。

セキュリティグループを作成し、下の表の各ポートについて新しいセキュリティグループルールを追加してください。手順については、OpenStack ガイド「Configure access and security for instances (インスタンスのアクセスとセキュリティを構成する)」を参照してください。

Port	サービス	説明
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設定でのセキュアなレプリケーションネットワークトンネル。 WireGuard を使用して暗号化されます。
8080	HTTP	プレーンテキストの Webベースの [Management Console]。 SSL を手動で無効にしない限り必要ありません。
8443	HTTPS	セキュアな Webベースの [Management Console]。基本的なインストールと設定に必要です。
9418	Git	シンプルなGitプロトコルのポートです。パブリックリポジトリのクローンとフェッチのみができます。暗号化されていないネットワーク通信。インスタンスでプライベートモードを有効化した場合、このポートをオープンする必要があるのは、匿名Git読み取りアクセスも有効化している場合のみです。詳しくは、「Enterprise でリポジトリ管理ポリシーを適用する」をご覧ください。

フローティングIPをインスタンスに関連づけることもできます。使用しているOpenStackのセットアップによっては、フローティングIPをプロジェクトに割り当て、それをインスタンスに関連づける必要があるかもしれません、そうする必要があるかどうかは、システム管理者に連絡を取って判断してください。詳細については、OpenStack ドキュメントの「Allocate a floating IP address to an instance (インスタンスへのフローティング IP アドレスの割り当て)」を参照してください。
これまでの手順で作成したイメージ、データボリューム、セキュリティグループを使って、お使いの GitHub Enterprise Server インスタンスを起動します。手順については、OpenStack ガイド「Launch and manage instances (インスタンスの起動と管理)」を参照してください。

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

インスタンスを構成するには、ライセンスファイルのアップロード、ルート [Management Console] パスワードの設定、インスタンスの設定の構成、インスタンスの再起動を行う必要があります。

警告

攻撃者が新しいインスタンスを侵害できないようにするには、自分だけが知っているルート [Management Console] パスワードを設定し、できるだけ早く最初のユーザーを作成します。

仮想マシンのパブリックDNS名をコピーして、Webブラウザに貼り付けてください。
プロンプトでライセンスファイルをアップロードし、管理コンソールのパスワードを設定してください。詳しくは、「GitHub Enterprise のライセンスのダウンロード」をご覧ください。
[Management Console] で、目的の設定を構成して保存します。詳細については、「GitHub Enterprise の構成」を参照してください。
インスタンスは自動的に再起動します。1. [Visit your instance](インスタンスにアクセスする) をクリックします。

参考資料

        [AUTOTITLE](/admin/overview/system-overview)

        [AUTOTITLE](/admin/overview/about-upgrades-to-new-releases)