EKS/AKS 上的 Automation Suite 安装指南

上次更新日期 2025年11月13日

升级 Automation Suite

Automation Suite 由多个组件组成。您作为客户和 UiPath™ 共同承担这些组件的责任。有关详细信息，请参阅职责矩阵。

您负责升级:

部署 Automation Suite 的 Kubernetes 基础架构（ AKS 或 EKS ）
您选择作为 Automation Suite 的一部分引入的组件（例如，Gatekeeper、FluentD 等）

UiPath™ 负责升级：

UiPath™ 服务（例如 Orchestrator）
作为 Automation Suite 一部分部署的组件（例如，ArgoCD）

升级 UiPath™ 服务和组件

准备

备注：

如果升级到 Automation Suite 2.2510 或更高版本，则需要为AutomationSuite_Airflow引入 PostgreSQL 数据库，并在input.json中为其配置连接字符串。

有关详细信息，请参阅特定于 Process Mining 的配置。
如果您使用 Studio Web 从 2.2510.0 之前的版本升级，请确保使用与storage_class_single_replica中指定的相同的存储类名称，以支持 RWX 访问模式。

有关详细信息，请参阅配置 input.json 。

要准备升级，请执行以下步骤：

请查看兼容性矩阵，以确定每个可用升级方案的受支持版本。如果您自带组件，请确保组件的版本与您计划升级到的版本兼容。有关详细信息，请参阅兼容性矩阵。
在管理计算机上下载适用于要升级到的版本的 versions.json 和 uipathctl。有关下载说明，请参阅下载安装包。
生成最新的input.json文件，如下所示：
- 选项 A：要获取 input.json 文件的最新修订，请运行以下命令：
```
uipathctl manifest get-revisionuipathctl manifest get-revision
```
- 选项 B：要列出所有过去的 input.json 文件并确定要选择的文件，请运行以下命令：
```
uipathctl manifest list-revisionsuipathctl manifest list-revisions
```
如果您将离线设置与符合 OCI 的外部注册表一起使用，则必须在升级前将注册表与容器映像和 Helm 图表结合使用。有关详细信息，请参阅使用离线捆绑包结合使用注册表。
如果已安装 Process Mining，并且您想使用需要 PostgreSQL 的最新版本 Airflow，则升级前必须在cluster_config.json文件中添加或更新适用于 PostgreSQL 的sqlalchemy连接字符串模板： postgresql_connection_string_template_sqlalchemy_pyodbc 。
```
postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>
```
如果安装了 Integration Service，请确保已同步外部云队列 (SQS) 并启用跨区域复制。例如：
- 在 Azure 队列存储中，配置“GRS/RA-GRS”或“GZRS/RA-GZRS”冗余选项。有关更多详细信息，请参阅：
- 在 Amazon SQS 中，在每个区域中创建 SQS 队列，并使用 SNS 扇出或自定义逻辑复制消息。有关更多详细信息，请参阅：
  - Amazon SQS – 主动/主动灾难恢复
  - SNS 跨区域消息传递

执行

要升级 UiPath™ 服务和组件，请执行以下步骤

确认您的集群运行状况良好：
```
uipathctl health checkuipathctl health check
```
将集群置于维护模式以保证备份一致性：
```
uipathctl cluster maintenance enableuipathctl cluster maintenance enable
```
重要提示：
此操作会导致停机，并且在启用维护模式时，您的业务自动化将暂停。

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

uipathctl cluster maintenance is-enableduipathctl cluster maintenance is-enabled

备份集群和 SQL 数据库，然后检查备份是否成功完成。
重要提示：
强烈建议在升级 Automation Suite 之前创建集群和 SQL 数据库的备份。这是为了确保您可以在升级操作期间出现问题时还原集群。在升级 Kubernetes 基础架构之前，这也适用。
Make sure to copy the value of global.userInputs.identity.krb5KeytabSecret to global.kerberosAuthConfig.userKeytab, if you simultaneously meet the following requirements:
- 您已使用用户名和密码配置了 Active Directory 集成
- 您已启用 Windows 身份验证
- 您不使用 SQL 集成身份验证
升级 UiPath™ 服务和组件：
```
uipathctl cluster upgrade input.json --versions versions.jsonuipathctl cluster upgrade input.json --versions versions.json
```
重要提示：
警告：此操作将导致停机，并且在整个升级过程中，您的业务自动化将暂停。请务必仅在维护窗口期间执行升级。
升级后检查集群是否运行正常：
```
uipathctl health checkuipathctl health check
```
注意：升级到 Automation Suite 2.2510 或更高版本时（如果先前安装了适用于 Process Mining 或 Task Mining 的 Dapr 和证书管理器插件），则可以卸载这些插件。有关详细信息，请参阅“卸载 Dapr”和“卸载证书管理器”部分。

升级 Kubernetes 基础架构

注意：Automation Suite 支持 Kubernetes 的上游 N-1 到 N-3 版本，与云提供商无关。例如，如果上游版本为 1.27，则我们支持版本 1.26、1.25 和 1.24。有关受支持的版本，请参阅兼容性矩阵。

您负责升级托管 Automation Suite 的 Kubernetes 基础架构。您应该遵循公司的标准实践来升级 Kubernetes 基础架构。

执行升级后操作

在下表中描述了执行升级后操作时必须执行的可能场景：

条件	操作
1.您已升级到 Automation Suite 2.2510.0 或更高版本。	您必须立即重新激活每个组织和主机的现有许可证。在线激活：升级后直接重新激活。离线激活：从 Automation Suite 实例生成新的激活有效负载文件，然后在“激活”中上传。不允许重用旧激活文件，否则将导致许可证无效。