High Availability Add-on 配置

有关 Automation Suite 中适用于同一个集群和外部计算机部署的 High Availability Add-on 配置选项的参考。

Automation Suite 支持安装在同一集群或外部计算机上的 High Availability Add-on (HAA)。

备注：

您必须配置 HAA，才能为多节点设置启用实际的 HA 设置。为此，您可以为安装程序提供 HAA 许可证，也可以在外部计算机上安装 HAA 并将 HAA 配置提供给安装程序。

集群内 Redis High Availability Add-on 配置

In a multi-node HA-ready production setup, High Availability (HA) is enabled by default. However, the Redis-based in-memory cache used by cluster services runs on a single node and represents a single point of failure. Therefore, if you have not purchased a High Availability Add-on (HAA) license, a cache node failure or restart will result in downtime for the entire cluster.

To prevent such an incident, you can purchase HAA, which enables redundant, multi-node HA-ready production deployment of the cache.

备注：

所有安装都包括具有单节点许可证的 HAA 软件。此许可证是免费的，无需购买。

如果您希望跨多个节点启用 HAA，则需要购买 HAA 许可证。这将在多节点 HA 就绪生产设置中实现集群的完全高可用性。

HAA 基于 Redis 技术。

为此，请执行以下步骤：

1. 购买 HAA 许可证。有关详细信息，请联系 UiPath™。
2. 更新 cluster_config.json 文件中的以下字段：
   • fabric.redis.license - 输入已转换为单个 Base64 字符串的 HAA 许可证。您需要将整个许可证密钥编码为 Base64，包括文本-----LICENSE START----- and -----LICENSE END----- 。在 Bash 中，您可以使用以下命令来执行此操作：

     echo '-----LICENSE START-----<license_key_here>-----LICENSE END-----' | base64 -w0
     

   • fabric.redis.ha - 使用 true 启用 HAA，并确保配置 fabric.redis.license 参数。这将启用 HAA 数据库复制，并将 HAA Pod 的数量增加到 3。默认情况下，fabric.redis.ha 设置为 false。
     备注：

     如果启用了 redis.ha，则需要将 redis.license 设置为支持两个以上分片的许可证。

     "fabric": {
         "redis": { 
             "ha": "true",
             "license": "Base64String" // Replace Base64String with the encoded full license string.
         }
     }
     

3. 重新运行结构安装程序：

   ./install-uipath.sh -i cluster_config.json -f -o output.json --accept-license-agreement
   

更新 Redis 许可证

要更新 Redis 许可证，请执行以下步骤：

1. 设置 kubectl 和 ArgoCD 访问权限：

   1. 在主节点上启用 kubectl 访问权限。有关说明，请参阅启用 kubectl 。
   2. 启用对 ArgoCD 的访问权限。有关说明，请参阅访问 ArgoCD 。

2. 检查当前许可证状态：

   要检查当前许可证的状态，请运行以下 Shell 命令：

   kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq
   

   • 在安装程序中包含的许可证到期日期之后部署的集群将显示 4 个分片的试用许可证，该许可证将在 30 天后过期，如以下示例所示：

   

   • 已在运行的集群会在许可证过期时显示以下状态：

   

3. 更新现有许可证：

   1. 要更新现有许可证，请运行以下 Shell 命令：

      kubectl patch application fabric-installer -n argocd \
      --type=json -p '[{"op":"add","path":"/spec/source/helm/parameters/-","value":{"name": "global.redis.license", "value": "<LICENSE_KEY_IN_BASE64>"}}]'
      

      

   2. 要查看是否已应用更改，请访问 ArgoCD。有关说明，请参阅访问 ArgoCD 。

   3. 如果结构安装程序应用程序显示为不同步，并且同步过程未自动触发，请自行选择“同步”按钮。如果您使用的是较旧的 Automation Suite 版本，则可能会发生这种情况。

      

      

      

      备注：

      ArgoCD 用户界面显示已同步的应用程序与 Redis 运算符成功应用新许可证之间存在一小段延迟。

   4. 要在 Redis 运算符尝试应用许可证时查看其日志，请运行以下命令：

      kubectl logs -n redis-system --since=300s -l name=redis-enterprise-operator -c redis-enterprise-operator --tail=-1 | grep license
      

      

   5. 如果您尝试应用过期的许可证，或者运行附带过期许可证的安装程序，您将获得以下输出：

      

   6. 要在运行旧版安装程序之前更新 Redis 许可证，请更新 <installer_folder>/defaults.json 中的 fabric.redis.license 密钥：

      

4. 检查是否应用了新许可证：

   要检查是否应用了新许可证，请运行以下 Shell 命令：

   kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq
   

   在下图中，您可以看到 Redis 集群从 30 天试用许可证切换到单分片 10 年许可证。

   

外部 High Availability Add-on 配置

选择 Automation Suite 的主动/主动配置时，必须使用外部集群托管的 High Availability Add-on。在所有其他情况下，它只是可选的。

要配置 High Availability Add-on，必须更新cluster_config.json文件中的以下参数：

参数	描述
fabric.redis.hostname	提供 High Availability Add-on (HAA) 服务器的 FQDN。
fabric.redis.password	提供用于连接到 HAA 服务器的密码。
fabric.redis.port	提供 HAA 服务器的端口。
fabric.redis.tls	启用 TLS 协议。默认情况下，启用 TLS。 如果在启用 TLS 时需要证书，请确保通过additional_ca_certs标志提供证书。有关详细信息，请参阅证书配置。

"fabric": {
  "redis": {
    "hostname": "redis_fqdn",
    "password": "credential_to_connect_redis",
    "port": 6380,
    "tls": true,
  }
}