インストール後に FQDN を設定する

Automation Suite の FQDN を更新するには、 cluster_config.json ファイルを更新して uipathctl インストーラーを実行する必要があります。

FQDN の更新プロセスは、シングルノードの評価モードおよびマルチノードの高可用性対応の運用環境モードの両方に適用できます。

注:

FQDN を変更する場合、新しいサーバー証明書が必要になります。 新しい証明書が使用できない場合は、インストーラーによって自動的に構成される、新しい自己署名証明書を使用してインストールを続行するか、インストールを中断して、証明機関が発行した新しい証明書を導入するという 2 つのオプションがあります。

証明書は、cluster_config.json ファイルの [server_certificate] フィールドで設定できます。

構成ファイルを新しい FQDN の値で更新する

注:

小文字の FQDN のみがサポートされています。FQDN では大文字を使用しないでください。

input.json ファイルで以下のパラメーターを更新する必要があります。要件に応じて、これらの値を自由に組み合わせて使用できます。

• fqdn - このフィールドを、クラスターへのアクセスに必要な新しい FQDN に更新します。
• fixed_rke_address - この値が cluster_config.jsonの fqdn フィールドと同じ場合、2 つの値が一致していて新しい FQDN を反映していることを確認する必要があります。アクティブ/パッシブまたはアクティブ/アクティブ設定の場合、この値は cluster_fqdnと一致する必要があります。
• cluster_fqdn - アクティブ/パッシブまたはアクティブ/アクティブ クラスター用にこのフィールドを更新します。
  注:

  いずれかのクラスターのロード バランサー レベルで DNS 構成を変更する場合は、cluster_fqdn更新が必要です

以下の例は、FQDN を更新するために必要な cluster_config.json の構成を示しています。

{
  "fqdn": "new-automationsuite.mycompany.com" //this is the fqdn for accessing the automation suite cluster
  "fixed_rke2_address": "new-automationsuite.mycompany.com,"//this is only required for the node joining, if customer wish to change "cluster_fqdn": "new-primary-automationsuite.mycompany.com" //this is only required for the a/p or a/a cluster
}

インフラストラクチャ レベルで FQDN を更新する

インフラストラクチャ レイヤーで FQDN を更新するには、最初のサーバー マシンでのみインストーラーを実行します。これにより、残りのサーバー ノード、エージェント ノード、特殊なエージェント ノードを含む、クラスター内のその他のすべてのノードが更新されます。

FQDN を更新するには、次のコマンドを実行します。

./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions/helm-charts.json

注:

--force フラグを指定してコマンドを実行すると、警告プロンプトが上書きされ、FQDN の変更が直接実行されます。

インストーラーにより、FQDN の更新による影響について警告が表示されます。続行する前に確認を求められます。

[WARN]  You are about to change the FQDN of the Automation Suite Cluster.
        Changing the fqdn is a disruptive operation, and it will result in 
        disconnecting your robots, mobile orchestrator users, ML Activities, 
        and ML Skills and invalidating any pending user invites. 
        
        If you wish to continue type 'yes' and hit enter to continue.

コンポーネントおよびサービス レベルでの FQDN の更新

注:

プロキシ環境およびクラスター内環境では、FQDN のすべての更新手順が完了した後に insights-insightslooker-0 ポッドが応答しなくなる場合があります。ポッドが応答しなくなった場合は、「 Insights のトラブルシューティング 」セクションをご覧ください。これらの環境でアップデートを実行する際の予防措置として、このメモを使用してください。

FQDN を更新するには、次のコマンドを実行します。

./bin/uipathctl manifest apply /path/to/cluster_config.json --versions versions/helm-charts.json

注:

--force フラグを指定してコマンドを実行すると、警告プロンプトが上書きされ、FQDN の変更が直接実行されます。

インストーラーにより、FQDN の更新による影響について警告が表示されます。続行する前に確認を求められます。

[WARN]  You are about to change the FQDN of the Automation Suite Cluster.
        Changing the fqdn is a disruptive operation, and it will result in 
        disconnecting your robots, mobile orchestrator users, ML Activities, 
        and ML Skills and invalidating any pending user invites. 
        If you wish to continue type 'yes' and hit enter to continue.

FQDN に関連する新しい有効な証明書が存在しない場合も、警告が表示されます。証明書の検証に失敗した場合、CA によって発行された新しい証明書を指定するか、新しい自己署名証明書で続行するよう要求されます。

************************************************************************************
[ERROR] Validating certificate... Failed
[ERROR] Certificate doesn't have new-automationsuite.mycompany.com in the SAN
************************************************************************************

Certificate provided is invalid for the new fqdn, would you like us to configure the new self signed certificate?
If you wish to continue type `yes` and hit enter to continue.

注:

必ず Redis データベースからすべてのデータをクリアしてください。 これを行うには、FLUSHALL コマンドを実行します。

アクティブ/アクティブ デプロイの FQDN を更新する

アクティブ/アクティブ設定でプライマリ クラスターの FQDN を変更する場合は、以下の追加手順を実行する必要があります。

1. プライマリ クラスター用に新しい kubeconfig を生成します。

2. セカンダリ クラスターの cluster_config.json にある other_kube_configの下に、新しい kubeconfig を追加します。

3. セカンダリ クラスターで次のコマンドを実行します。

   uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json