クラスタの初期化

注: GitHub Enterprise Server のクラスタリングは HTTPS を使用して構成する必要があります。

GitHub Enterprise Serverのインストール

各クラスタノードで GitHub Enterprise Server をプロビジョニングしてインストールします。詳細については、「GitHub Enterprise Server インスタンスをセットアップする」を参照してく� さい。
管理シェルまたは DHCP を使用し、各ノードの IP アドレスのみを構成します。その他の設定は行わないでく� さい。

最初のノードの設定

cluster.conf で MySQL プライマリとして指定されるノードに接続します。詳しくは、「クラスター構成ファイルについて」を参照してく� さい。
Web ブラウザーで https://<ip address>:8443/setup/ に移動します。
プロンプトでライセンスファイルをアップロードし、管理コンソールのパスワードを設定してく� さい。詳細については、「GitHub Enterprise のライセンスの管理」を参照してく� さい。 3. [Management Console] で、目的の設定を構成して保存します。 4. インスタンスは自動的に再起動します。

クラスターを初期化するためには、クラスター設定ファイル (cluster.conf) が必要です。詳しくは、「クラスター構成ファイルについて」を参照してく� さい。

構成された最初のノードから ghe-cluster-config-init を実行します。実行すると、クラスタ設定ファイルに設定されていないノードがある� �合にクラスタを初期化します。
ghe-cluster-config-apply を実行する。これにより、cluster.conf ファイルを検証して各ノードファイルに設定を適用し、各ノードで設定されたサービスを起動します。

実行中のクラスターの状態を確認するには、ghe-cluster-status コマンドを使います。

クラスタ設定ファイルについて

クラスタ設定ファイル (cluster.conf) は、クラスター中のノードと、その上で動作するサービスを定義します。詳しくは、「クラスターノードについて」を参照してく� さい。

この例 cluster.conf では、5 つのノードでクラスターを定義します。

2 つのノード (ghe-app-node-\* と呼ばれる) によって、クライアント要求に応答する web-server サービスと job-server サービスが実行されます。
3 つのノード (ghe-data-node-\* と呼ばれる) は、GitHub Enterprise Server データの保存と取得のサービスを実行します。

ノードの名前には、ホスト名として有効な任意の名前を選択できます。この名前は各ノードのホスト名として設定され、各ノードの /etc/hosts に追� され、各ノードがローカルでお互いを解決できるようにします。

mysql-server と mysql-master 経由で MySQL プライマリとして構成した最初のクラスターノードを指定します。

[cluster]
  mysql-master = ghe-data-node-1
  redis-master = ghe-data-node-1
  primary-datacenter = default
[cluster "ghe-app-node-1"]
  hostname = ghe-app-node-1
  ipv4 = 192.168.0.2
  # ipv6 = fd12:3456:789a:1::2
  web-server = true
  job-server = true
[cluster "ghe-app-node-2"]
  hostname = ghe-app-node-2
  ipv4 = 192.168.0.3
  # ipv6 = fd12:3456:789a:1::3
  web-server = true
  job-server = true
[cluster "ghe-data-node-1"]
  hostname = ghe-data-node-1
  ipv4 = 192.168.0.4
  # ipv6 = fd12:3456:789a:1::4
  consul-server = true
  consul-datacenter = default
  git-server = true
  pages-server = true
  mysql-server = true
  elasticsearch-server = true
  redis-server = true
  memcache-server = true
  metrics-server = true
  storage-server = true
[cluster "ghe-data-node-2"]
  hostname = ghe-data-node-2
  ipv4 = 192.168.0.5
  # ipv6 = fd12:3456:789a:1::5
  consul-server = true
  consul-datacenter = default
  git-server = true
  pages-server = true
  mysql-server = true
  elasticsearch-server = true
  redis-server = true
  memcache-server = true
  metrics-server = true
  storage-server = true
[cluster "ghe-data-node-3"]
  hostname = ghe-data-node-3
  ipv4 = 192.168.0.6
  # ipv6 = fd12:3456:789a:1::6
  consul-server = true
  consul-datacenter = default
  git-server = true
  pages-server = true
  mysql-server = true
  elasticsearch-server = true
  redis-server = true
  memcache-server = true
  metrics-server = true
  storage-server = true

構成された最初のノードでファイル /data/user/common/cluster.conf を作成します。たとえば、vim を使用する� �合は次のようになります。

ghe-data-node-1:~$ sudo vim /data/user/common/cluster.conf

クラスタの初期化

この記事では、次の� �目が扱われます。

GitHub Enterprise Serverのインストール

最初のノードの設定

クラスタの初期化

クラスタ設定ファイルについて