UiPath Documentation
automation-suite
2.2510
true
Linux の Automation Suite のインストール ガイド
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

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

インストール後に cluster_config.json および uipathctl を使用して Automation Suite の 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": "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
}

手順 1: インフラストラクチャ レベルで FQDN を更新する​

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

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

./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions/helm-charts.json
./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.
[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.

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

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

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

./bin/uipathctl cluster maintenance enable
./bin/uipathctl cluster maintenance enable

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

./bin/uipathctl cluster maintenance is-enabled
./bin/uipathctl cluster maintenance is-enabled

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

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

./bin/uipathctl manifest apply /path/to/cluster_config.json --versions versions/helm-charts.json
./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.
[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.
************************************************************************************
[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 コマンドを実行します。

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

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

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

./bin/uipathctl cluster maintenance disable
./bin/uipathctl cluster maintenance disable

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

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

  1. プライマリ クラスターでメンテナンス モードを有効化します。

    ./bin/uipathctl cluster maintenance enable
    ./bin/uipathctl cluster maintenance enable
    
  2. プライマリ クラスター用に新しい kubeconfig を生成します。

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

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

    uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json
    uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json
    
  5. プライマリ クラスターでメンテナンス モードを無効化します。

    ./bin/uipathctl cluster maintenance disable
    ./bin/uipathctl cluster maintenance disable
    

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得