OpenShift 上的 Automation Suite 安装指南

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

升级 Automation Suite

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

您负责升级:

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

UiPath™ 负责升级：

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

升级 UiPath™ 服务和组件

准备

备注：

如果您升级到 Automation Suite 2024.10.3 或更高版本，并且需要最新版本的 Airflow，则需要为AutomationSuite_Airflow使用 PostgreSQL 数据库，并在input.json中为其配置连接字符串。

有关详细信息，请参阅特定于 Process Mining 的配置。

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

请查看兼容性矩阵，以确定每个可用升级方案的受支持版本。如果您自带组件，请确保组件的版本与您计划升级到的版本兼容。有关详细信息，请参阅兼容性矩阵。
在管理计算机上下载适用于要升级到的版本的 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>
```
备注：
这仅适用于 Automation Suite 2024.10.3 或更高版本上的 Process Mining。

执行

要升级 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 集成身份验证
禁用维护模式：
```
uipathctl cluster maintenance disableuipathctl cluster maintenance disable
```
注意：升级前必须禁用维护模式。 Automation Suite 升级流程不支持启用维护模式。
升级 UiPath™ 服务和组件：
```
uipathctl cluster upgrade input.json --versions versions.jsonuipathctl cluster upgrade input.json --versions versions.json
```
重要提示：
警告：此操作将导致停机，并且在整个升级过程中，您的业务自动化将暂停。请务必仅在维护窗口期间执行升级。
升级后检查集群是否运行正常：
```
uipathctl health checkuipathctl health check
```
注意：如果您已升级到 Automation Suite 2024.10.3 或更高版本，则尚未启用 Task Mining，则可以卸载 Dapr 和 Cert Manager。有关更多详细信息，请参阅“卸载 Dapr”和“卸载证书管理器”部分。