在 EKS/AKS 上升级 Automation Suite

重要提示：

如果您使用 Active Directory (AD) 并计划升级到 2023.4.0，我们强烈建议您直接跳到 2023.4.3 版本，因为 2023.4.0、2023.4.1 和 2023.4.2 会受到 AD 问题的影响。

AKS/EKS 上的 Automation Suite 包含多个组件。 作为客户，您和 UiPath 共同承担这些组件的责任。 有关详细信息，请参阅 兼容性矩阵。

您负责升级:

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

UiPath 负责升级：

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

升级 UiPath™ 服务和组件

准备

备注：

AKS/EKS 版本 2023.10.0 到 2023.10.7 的 Automation Suite 中的备份逻辑存在已知问题。 具体来说，此问题不包括 Insights 仪表板的备份。但是，所有历史数据均已成功备份。

要将 Insights 仪表板包含在备份中，您必须使用此处提供的脚本重新配置备份解决方案。 此脚本允许您重新配置备份解决方案并创建备份。 有关如何执行该命令的详细信息，请参阅本节。

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

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

     uipathctl manifest get-revision

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

     uipathctl manifest list-revisions

执行

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

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

   uipathctl health check

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

   uipathctl cluster maintenance enable

   重要提示：

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

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

   uipathctl cluster maintenance is-enabled

4. 备份集群和 SQL 数据库，然后检查备份是否成功完成。
   重要提示：

   强烈建议在升级 Automation Suite 之前创建集群和 SQL 数据库的备份。 这是为了确保在升级操作期间出现问题时可以还原集群。

   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 集成身份验证
5. 禁用维护模式：

   uipathctl cluster maintenance disable

   注意：升级前必须禁用维护模式。 Automation Suite 升级流程不支持启用维护模式。
6. 升级 UiPath™ 服务和组件：

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

   重要提示：

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

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

   uipathctl health check

升级 Kubernetes 基础架构

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

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