升级 Automation Suite

在 EKS/AKS 上执行 Automation Suite 的主要和次要版本升级。

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

您负责升级:

• 部署了 Automation Suite （AKS 或 EKS）的 Kubernetes 基础架构
• 您选择作为 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
     

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

     uipathctl manifest list-revisions
     

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. 如果安装了 Integration Service，请确保已同步外部云队列 (SQS) 并启用跨区域复制。例如：

   • 在 Azure 队列存储中，配置“GRS/RA-GRS”或“GZRS/RA-GZRS”冗余选项。有关详细信息，请参阅：
     • Azure 存储中的数据冗余
     • Azure 队列存储中的可靠性
     • 异地冗余设计指南
   • 在 Amazon SQS 中，在每个区域中创建 SQS 队列，并使用 SNS 扇出或自定义逻辑复制消息。有关详细信息，请参阅：
     • Amazon SQS - 主动/主动灾难恢复
     • SNS 跨区域消息传递

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

执行

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

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

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

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

   uipathctl cluster maintenance enable
   

   重要提示：

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

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

   uipathctl cluster maintenance is-enabled
   

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

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

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

5. 从 Automation Suite 2.2510.2 开始维护模式在升级过程中必须保持启用状态。对于 Automation Suite 2.2510.2 之前的版本在执行升级之前禁用维护模式：

   uipathctl cluster maintenance disable
   

   备注：

   如果要升级到 Automation Suite 2.2510.2 或更高版本，请跳过此步骤，仅在升级完成后禁用维护模式。

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

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

   在 Automation Suite 2.2510.0 中，禁用维护模式时， uipathctl cluster upgrade命令将失败，并显示以下错误： Please enable maintenance mode prior to attempting an upgrade. Use 'uipathctl cluster maintenance enable'.

   为避免显示此错误消息，请使用以下命令执行升级。在继续操作之前，请确保已创建所有必需的备份。

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

   重要提示：

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

7. 从 Automation Suite 2.2510.2 开始禁用维护模式:

   uipathctl cluster maintenance disable
   

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

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

   备注：

   在升级到 Automation Suite 2.2510 或更高版本后，如果您以前安装了适用于 Process Mining 或 Task Mining 的 Dapr 和 Cert Manager 插件，则可以卸载这些插件。有关详细信息，请参阅“卸载 Dapr”和“卸载 Cert Manager”部分。

升级 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 或更高版本，并且在以前的版本中启用了 Process Mining 或 Task Mining：

  • 卸载 Dapr。有关详细信息，请参阅如何卸载 Dapr 。
  • 卸载证书管理器。有关详细信息，请参阅如何卸载证书管理器。

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

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

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