升级 Automation Suite

在 OpenShift 集群上将 Automation Suite 升级到较新版本。

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

您负责升级:

• 部署 Automation Suite 的 Kubernetes 基础架构 (OpenShift)
• 您选择作为 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 。

此外，在开始升级之前，请查看以下数据库维护指南。

重要提示：

非常大的 Automation Suite 数据库表格可能会导致数据库迁移作业花费更长时间，或者在升级期间无法完成。维护良好的数据库表格可降低这种风险。

我们建议在开始升级之前存档或清除大批量表格中不再需要的数据；有关详细信息，请参阅执行数据库维护。

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

1. 请查看兼容性矩阵，以确定每个可用升级方案的受支持版本。如果您自带组件，请确保组件的版本与您计划升级到的版本兼容。有关详细信息，请参阅兼容性矩阵。
2. 在管理计算机上下载适用于要升级到的版本的versions.json和uipathctl 。有关下载说明，请参阅“下载安装包” 。
3. 生成最新的input.json文件，如下所示：
   • 选项 A：要获取input.json文件的最新修订，请运行以下命令：

     uipathctl manifest get-revision --namespace <uipath>
     

   • 选项 B：要列出所有过去的input.json文件并确定要选择的文件，请运行以下命令：

     uipathctl manifest list-revisions --namespace <uipath>
     

4. 如果您使用离线设置与符合 OCI 的外部注册表，则必须在升级前将注册表与容器映像和 Helm 图表结合使用。有关详细信息，请参阅使用离线捆绑包结合使用注册表。
5. 如果已安装 Process Mining，并且您想使用需要 PostgreSQL 的最新版本 Airflow，则升级前必须在input.json文件中添加或更新适用于 PostgreSQL 的sqlalchemy连接字符串模板： postgresql_connection_string_template_sqlalchemy_pyodbc 。

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>
   

6. 如果您从 Automation Suite 2024.10 的早期版本升级到 Automation Suite 2.2510.0 或更高版本并启用了 Studio Web，则还必须启用解决方案。有关详细信息，请参阅启用或禁用解决方案。请务必查看解决方案的其他硬件要求。有关详细信息，请参阅“容量规划” 。

执行

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

1. 确认您的集群运行状况良好：

   uipathctl health check --namespace <uipath> --versions versions.json
   

2. 将集群置于维护模式以保证备份一致性：

   uipathctl cluster maintenance enable --namespace <uipath>
   

   重要提示：

   此操作会导致停机，并且在启用维护模式时，您的业务自动化将暂停。

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

   uipathctl cluster maintenance is-enabled --namespace <uipath>
   

4. 备份集群和 SQL 数据库，然后检查备份是否已成功完成。在升级 Kubernetes 基础架构之前，也要创建备份。

   如果您同时满足以下要求，请确保将global.userInputs.identity.krb5KeytabSecret的值复制到global.kerberosAuthConfig.userKeytab ：

   • 您已使用用户名和密码配置了 Active Directory 集成
   • 您已启用 Windows 身份验证
   • 您不使用 SQL 集成身份验证

5. 禁用维护模式：

   uipathctl cluster maintenance disable
   

   备注：

   升级前，必须禁用维护模式。Automation Suite 升级流程不支持启用维护模式。

6. 升级 UiPath™ 服务和组件：

   uipathctl cluster upgrade input.json --versions versions.json
   

   重要提示：

   警告：此操作将导致停机，并且在整个升级过程中，您的业务自动化将暂停。请务必仅在维护窗口期间执行升级。

7. 升级后检查集群是否运行正常：

   uipathctl health check --namespace <uipath> --versions versions.json
   

   备注：

   如果升级到 Automation Suite 2.2510 或更高版本，前提是以前安装了适用于 Process Mining 或 Task Mining 的 Dapr 和证书管理器插件，则可以卸载这些插件。有关详细信息，请参阅和部分。

升级 Kubernetes 基础架构

备注：

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

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

执行升级后操作

以下场景描述了您的环境需要执行哪些升级后操作：

• 如果您已升级到 Automation Suite 2.2510.0 或更高版本，则必须立即重新激活每个组织和主机的现有许可证：

  • 在线激活：升级后直接重新激活。
  • 离线激活：从 Automation Suite 实例生成新的激活有效负载文件，然后在“激活”中上传。

  不允许重复使用旧的激活文件，旧版激活文件将导致许可证失效。必须使用“更新许可证”按钮来重新激活许可证。请勿手动停用然后重新激活许可证，因为这样做会禁用服务。