High Availabilityレプリカの作成

注: GitHub Enterprise Server では、最大で 8 つの高可用性レプリカ (パッシブとアクティブ/Go のいずれでも) が利用できます。

High Availabilityレプリカの作成

新しい GitHub Enterprise Server アプライアンスを希望するプラットフォームにセットアップします。レプリカアプライアンスのCPU、RAM、ストレージ設定は、プライマリアプライアンスと同じにするべきです。レプリカアプライアンスは、独立した環境にインストールすることをお勧めします。下位層のハードウェア、ソフトウェア、ネットワークコンポーネントは、プライマリアプライアンスのそれらとは分離されているべきです。クラウドプロバイダを利用している場合には、別個のリージョンもしくはゾーンを使ってください。詳しくは、「GitHub Enterprise Server インスタンスをセットアップする」を参照してください。
新しいアプライアンスが、ポート 122/TCP と 1194/UDP 経由で、この高可用性環境の他のすべてのアプライアンスと通信できることを確認します。詳しくは、「ネットワークポート」を参照してください。
ブラウザで新しいレプリカアプライアンスのIPアドレスにアクセスして、所有するGitHub Enterpriseのライセンスをアップロードしてください。
プライマリアプライアンス上のパスワードと一致する管理者パスワードを設定して続行します。
[レプリカとして構成] をクリックします。
"Add new SSH key（新しいSSH鍵の追加）"の下でSSH鍵を入力してください。
[キーの追加] をクリックします。
SSHを使ってレプリカアプライアンスのIPアドレスに接続してください。
```
ssh -p 122 admin@REPLICA_IP
```
レプリケーション用のキーの組を生成するには、プライマリアプライアンスの IP アドレスを指定して ghe-repl-setup コマンドを使用し、それが返す公開キーをコピーします。
```
ghe-repl-setup PRIMARY_IP
```
プライマリアプライアンスの承認されたキーのリストに公開キーを追加するには、https://PRIMARY-HOSTNAME/setup/settings を参照して、レプリカからコピーしたキーをリストに追加します。
新しいレプリカに対して、プライマリへの接続を確認してレプリカモードを有効にするには、ghe-repl-setup をもう一度実行します。
```
ghe-repl-setup PRIMARY_IP
```
データストアのレプリケーションを開始するには、ghe-repl-start コマンドを使います。
```
ghe-repl-start
```
警告: ghe-repl-start を実行すると、プライマリサーバーを短時間使えなくなり、その間、ユーザーには内部サーバーエラーが表示されることがあります。もっとわかりやすいメッセージを表示するには、ghe-repl-start をレプリカノードで実行する前にプライマリノード上で ghe-maintenance -s を実行し、アプライアンスをメンテナンスモードにします。レプリケーションを開始したら、ghe-maintenance -u を使ってメンテナンスモードを無効にします。プライマリノードがメンテナンスモードの間、Git レプリケーションは進行しません。
各データストアのレプリケーションチャネルの状態を確認するには、ghe-repl-status コマンドを使用します。
```
ghe-repl-status
```

Geo-replicationレプリカの作成

レプリカを作成する以下の例の設定では、1 つのプライマリと 2 つのレプリカを使用しており、これらは 3 つの異なる地域にあります。 3 つのノードは別のネットワークに配置できますが、すべてのノードは他のすべてのノードから到達可能である必要があります。最低限、必要な管理ポートは他のすべてのノードに対して開かれている必要があります。ポートの要件について詳しくは、「ネットワークポート」をご覧ください。

プライマリノードとレプリカノード間の待機時間は 70 ミリ秒未満である必要があります。ノードのネットワーク間にファイアウォールを設定することはお勧めしません。待ち時間が 70 ミリ秒を超える場合は、代わりにキャッシュレプリカノードをお勧めします。詳しくは、「リポジトリキャッシュの構成」を参照してください。

最初のレプリカで ghe-repl-setup を実行することで、標準の 2 ノード構成の場合と同じ方法で最初のレプリカを作成します。
```
(replica1)$ ghe-repl-setup PRIMARY_IP
(replica1)$ ghe-repl-start
```
2 つ目のレプリカを作成し、ghe-repl-setup --add コマンドを使用します。 --add フラグは、既存のレプリケーション構成を上書きするのを防ぎ、新しいレプリカを構成に追加します。
```
(replica2)$ ghe-repl-setup --add PRIMARY_IP
(replica2)$ ghe-repl-start
```
デフォルトでは、レプリカは同じデータセンターに設定され、同じノードにある既存のノードからシードを試行します。レプリカを別のデータセンターに設定するには、datacenter オプションに異なる値を設定します。具体的な値は、それらが互いに異なる限り、どのようなものでもかまいません。各ノードで ghe-repl-node コマンドを実行し、データセンターを指定します。

プライマリでは以下のコマンドを実行します。
```
(primary)$ ghe-repl-node --datacenter [PRIMARY DC NAME]
```
1 番目のレプリカでは以下のコマンドを実行します。
```
(replica1)$ ghe-repl-node --datacenter [FIRST REPLICA DC NAME]
```
2 番目のレプリカでは以下のコマンドを実行します。
```
(replica2)$ ghe-repl-node --datacenter [SECOND REPLICA DC NAME]
```
ヒント: --datacenter および --active オプションは同時に設定できます。
アクティブなレプリカノードは、アプライアンスデータのコピーを保存し、エンドユーザーのリクエストに応じます。アクティブではないノードは、アプライアンスデータのコピーを保存しますが、エンドユーザーのリクエストに応じることはできません。 --active フラグを使用してアクティブモードを有効にするか、--inactive フラグを使用して非アクティブモードを有効にします。

1 番目のレプリカでは以下のコマンドを実行します。
```
(replica1)$ ghe-repl-node --active
```
2 番目のレプリカでは以下のコマンドを実行します。
```
(replica2)$ ghe-repl-node --active
```
構成を適用するには、プライマリで ghe-config-apply コマンドを使用します。
```
(primary)$ ghe-config-apply
```

Geo-replicationのためのDNSの設定

プライマリとレプリカノードの IP アドレスを使って、Geo DNS を設定します。 SSH でプライマリノードにアクセスしたり、backup-utils でバックアップしたりするために、プライマリノード (たとえば、primary.github.example.com) に対して DNS CNAME を作成することもできます。

テストのために、ローカルワークステーションの hosts ファイル (たとえば、/etc/hosts) にエントリを追加することができます。以下の例のエントリでは、HOSTNAME に対する要求が replica2 に解決されることになります。別の行をコメントアウトすることで、特定のホストをターゲットにすることができます。

# <primary IP>      HOSTNAME
# <replica1 IP>     HOSTNAME
<replica2 IP>     HOSTNAME

参考資料

「High Availability設定について」
「Geo-replicationについて」

High Availabilityレプリカの作成

この記事の内容