- 概述
- 要求
- 安装
- 安装后
- 迁移和升级
- 在 EKS/AKS 上升级 Automation Suite
- 从 Linux 上的 Automation Suite 迁移到 EKS/AKS 上的 Automation Suite
- 监控和警示
- 集群管理
- 特定于产品的配置
- 故障排除
在 EKS/AKS 上升级 Automation Suite
升级 EKS/AKS 上的 Automation Suite,包括针对 UiPath 和客户管理的组件的共享责任准则。
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 仪表板的备份。但是,所有历史数据均已成功备份。
要准备升级,请执行以下步骤:
- 请查看兼容性矩阵,以确定每个可用升级方案的受支持版本。如果您自带组件,请确保组件的版本与您计划升级到的版本兼容。有关详细信息,请参阅兼容性矩阵。
- 在管理计算机上下载适用于要升级到的版本的
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
- 选项 A:要获取
- 如果您使用离线设置与符合 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 2023.10.9 或更高版本上的 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.krb5KeytabSecrettoglobal.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。有关更多详细信息,请参阅和部分。
升级 Kubernetes 基础架构
Automation Suite 支持 Kubernetes 的上游 N-1 到 N-3 版本,与云提供商无关。例如,如果上游版本为 1.27,则我们支持版本 1.26、1.25 和 1.24。有关受支持的版本,请参阅兼容性矩阵。
您负责升级托管 Automation Suite 的 Kubernetes 基础架构。您应该遵循公司的标准实践来升级 Kubernetes 基础架构。