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

EKS/AKS への Automation Suite のインストール後に FQDN の設定を更新します。

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

注:

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

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

共有クラスターでの Automation Suite のインストールの場合、インストーラーは、 <istio-system> 名前空間の管理者権限を持っている場合にのみ、新しい証明書を自動的に構成できます。

Automation Suite インストーラーに管理者権限が付与されていない場合は、次の手順に進む前に、「 Istio を構成し、WASM プラグインをルーティング用にインストールする 」の最後にあるメモの指示に従う必要があります。

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

注:

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

input.json ファイルで、fqdn パラメーターをクラスターへのアクセスに使用する新しい FQDN で更新します。

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

{
  "fqdn": "new-automationsuite.mycompany.com" //this is the fqdn for accessing the automation suite cluster
}

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

手順 1: メンテナンス モードを有効化する

FQDN の更新をトリガーする前に、メンテナンス モードを有効化する必要があります。これにより、イングレス コントローラーとすべての UiPath® サービスがシャットダウンし、Automation Suite クラスターへのすべての受信トラフィックがブロックされます。

クラスターをメンテナンス モードにするには、以下を実行します。

uipathctl cluster maintenance enable

クラスターがメンテナンス モードであることを確認するには、以下を実行します。

uipathctl cluster maintenance is-enabled

手順 2: コンポーネントとサービスのレベルで FQDN を更新する

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

uipathctl manifest apply input.json --versions versions.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 コマンドを実行します。

手順 3: メンテナンス モードを無効化する

FQDN の更新後、メンテナンス モードを無効化して、トラフィックを Automation Suite クラスターに復元します。

メンテナンス モードを無効化するには、次のコマンドを実行します。

uipathctl cluster maintenance disable

詳しくは、「 uipathctl クラスターのメンテナンスの無効化」をご覧ください。