安装后配置 FQDN

参考，了解安装后通过 cluster_config.json 和 uipathctl 更新 Automation Suite FQDN。

如要更新 Automation Suite 的 FQDN，必须更新cluster_config.json文件并运行uipathctl安装程序。

FQDN 更新过程适用于单节点评估模式和多节点 HA 就绪生产模式。

备注：

更改 FQDN 需要新的服务器证书。 如果新证书不可用，您有两个选择：继续使用安装程序自动配置的新自签名证书，或停止安装并引入新的 CA 颁发的证书。

您可以通过cluster_config.json文件中的server_certificate字段配置证书。

使用新的 FQDN 值更新配置文件

备注：

我们仅支持小写 FQDN。不要在 FQDN 中使用大写字符。

您必须更新 input.json 文件中的以下参数。根据您的要求，可以使用这些值的任意组合。

• fqdn - 使用访问集群所需的新 FQDN 更新此字段。
• fixed_rke_address - 如果此值与cluster_config.json中的fqdn字段相同，则必须确保两个值匹配以反映新的 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
}

步骤 1：在基础架构级别更新 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.

步骤 2：启用维护模式

在组件和服务级别触发 FQDN 更新之前，必须启用维护模式。这将关闭入口控制器和所有 UiPath™ 服务，并阻止所有传入 Automation Suite 集群的流量。

要将集群置于维护模式，请运行：

./bin/uipathctl cluster maintenance enable

要验证集群是否处于维护模式，请运行：

./bin/uipathctl cluster maintenance is-enabled

步骤 3：在组件和服务级别更新 FQDN

要更新 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 命令来执行此操作。

步骤 4：禁用维护模式

更新 FQDN 后，禁用维护模式以恢复 Automation Suite 集群的流量。

要禁用维护模式，请运行：

./bin/uipathctl cluster maintenance disable

有关详细信息，请参阅uipathctl cluster Maintenance disable 。

在主动/主动部署中更新 FQDN

如果您在主动/主动设置中更改主集群的 FQDN，则需要执行以下额外步骤：

1. 在主集群上启用维护模式：

   ./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
   

5. 在主集群上禁用维护模式：

   ./bin/uipathctl cluster maintenance disable
   

   有关详细信息，请参阅uipathctl cluster Maintenance disable 。