High Availability Add-on の構成

Automation Suite supports High Availability Add-on (HAA) installed either in the same cluster or on external machines.

注:

You must configure HAA to enable the actual HA setup for the multi-node setup. To do that, you can either provide the HAA license to the installer or install HAA on the external machines and give the HAA configurations to the installer.

クラスター内の Redis High Availability Add-on の構成

マルチノードの高可用性対応の運用環境設定では、高可用性 (HA) が既定で有効化されます。ただし、クラスターサービスが使用する Redis ベースのインメモリキャッシュはシングルノードで実行され、単一障害点となります。キャッシュノードの障害や再起動の影響を軽減するには、冗長性を備えたマルチノードの高可用性対応の運用環境のキャッシュのデプロイを可能にする High Availability Add-on (HAA) を購入してください。

注:

すべてのインストールに、シングルノードライセンスを伴う HAA ソフトウェアが付属しています。このライセンスは無料で、購入は不要です。

複数のノードで HAA を有効化する場合は、HAA ライセンスの購入が必要になります。ライセンスを購入することで、マルチノードの HA 対応の運用環境の設定のクラスターに高可用性の全機能が実装されます。

HAA は Redis 技術に基づいています。

そのためには、以下の手順に従ってください。

HAA ライセンスを購入します。詳細については、UiPath® までお問い合わせください。
cluster_config.json ファイルの、以下のフィールドを更新します。
- fabric.redis.license - 単一の Base64 文字列に変換した HAA ライセンスを入力します。Bash ならば echo 'license_text_here' | base64 -w0 を使用することでこれを実行できます。
- fabric.redis.ha - true を使用して HAA を有効化し、fabric.redis.license パラメーターも構成します。これにより、HAA データベースのレプリケーションが有効化され、HAA ポッドの数が 3 まで増えます。既定で fabric.redis.ha は false に設定されます。
  
  注: redis.ha が有効な場合、redis.license は 3 つ以上のシャードをサポートするライセンスに設定する必要があります。
```
"fabric": {
    "redis": { 
        "ha": "true",
        "license": Base64String
    }
}"fabric": {
    "redis": { 
        "ha": "true",
        "license": Base64String
    }
}
```

ファブリックインストーラーを再実行します。

./install-uipath.sh -i cluster_config.json -f -o output.json --accept-license-agreement./install-uipath.sh -i cluster_config.json -f -o output.json --accept-license-agreement

Redis ライセンスを更新する

Redis ライセンスを更新するには、次の手順に従います。

kubectl と ArgoCD へのアクセスを設定します。
1. プライマリノードで kubectl アクセスを有効化します。詳しくは、「kubectl を有効化する」をご覧ください。
2. ArgoCD へのアクセスを有効化します。手順については、「ArgoCD にアクセスする」をご覧ください。
現在のライセンスステータスを確認します。
現在のライセンスのステータスを確認するには、次のシェルコマンドを実行します。
```
kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jqkubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq
```
- インストーラーに含まれるライセンスの有効期限が切れた後にデプロイされたクラスターには、次の例のように、30 日間で有効期限が切れる無料トライアルの 4 シャードのライセンスが表示されます。
- ライセンスの有効期限が切れたときに既に実行されていたクラスターには、次のステータスが表示されます。
既存のライセンスを更新します。
1. 既存のライセンスを更新するには、次のシェルコマンドを実行します。
```
kubectl patch application fabric-installer -n argocd \
--type=json -p '[{"op":"add","path":"/spec/source/helm/parameters/-","value":{"name": "global.redis.license", "value": "<LICENSE_KEY_IN_BASE64>"}}]'kubectl patch application fabric-installer -n argocd \
--type=json -p '[{"op":"add","path":"/spec/source/helm/parameters/-","value":{"name": "global.redis.license", "value": "<LICENSE_KEY_IN_BASE64>"}}]'
```
2. 変更が適用されたかどうかを確認するには、ArgoCD にアクセスします。手順については、「ArgoCD にアクセスする」をご覧ください。
3. fabric-installer アプリケーションが同期されていない可能性があり、同期プロセスが自動的にトリガーされなかった場合は、[SYNC] ボタンを自身でクリックします。これは、古いバージョンの Automation Suite を使用している場合に発生する可能性があります。
  
  注: ArgoCD UI にアプリが同期されたことが表示されてから、Redis Operator が新しいライセンスを正常に適用するまでに、少し時間がかかる場合があります。
4. ライセンスを適用しようとしたときの Redis Operator のログを表示するには、次のコマンドを実行します。
```
kubectl logs -n redis-system --since=300s -l name=redis-enterprise-operator -c redis-enterprise-operator --tail=-1 | grep licensekubectl logs -n redis-system --since=300s -l name=redis-enterprise-operator -c redis-enterprise-operator --tail=-1 | grep license
```
5. 期限切れのライセンスを適用しようとした場合や、期限切れのライセンスが付属するインストーラーを実行した場合、次の出力が表示されます。
6. 古いインストーラーで使用されている Redis ライセンスをインストーラーの実行前に更新するには、<installer_folder>/defaults.json の fabric.redis.license キーを更新します。
新しいライセンスが適用されていることを確認します。
新しいライセンスが適用されているかどうかを確認するには、次のシェルコマンドを実行します。
```
kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jqkubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq
```
以下の図は、Redis クラスターが無料トライアルの 30 日間のライセンスから、単一シャードの 10 年間のライセンスに切り替わっていることがわかります。

外部 High Availability Add-on の構成

Automation Suite のアクティブ/アクティブ構成を選択する場合、外部クラスターでホストされる High Availability Add-on が必須です。他のすべての状況では、これは単にオプションです。

High Availability Add-on を構成するには、 cluster_config.json ファイル内の以下のパラメーターを更新する必要があります。

パラメーター	説明
`fabric.redis.hostname`	High Availability Add-on (HAA) サーバーの FQDN を指定します。
`fabric.redis.password`	HAA サーバーに接続するためのパスワードを入力します。
`fabric.redis.port`	HAA サーバーのポートを指定します。
`fabric.redis.tls`	TLS プロトコルを有効化します。既定では、TLS は有効になっています。注: TLS が有効なときに証明書が必要な場合は、必ず `additional_ca_certs` フラグを使用して証明書を指定してください。詳細については、「証明書の構成」をご覧ください。

"fabric": {
  "redis": {
    "hostname": "redis_fqdn",
    "password": "credential_to_connect_redis",
    "port": 6380,
    "tls": true,
  }
}"fabric": {
  "redis": {
    "hostname": "redis_fqdn",
    "password": "credential_to_connect_redis",
    "port": 6380,
    "tls": true,
  }
}