安装后配置 FQDN

使用证书验证和维护模式在 OpenShift 上安装后更新 Automation Suite 的 FQDN。

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

备注：

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

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

只有在<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 cluster Maintenance disable 。