UiPath Documentation
automation-suite
2023.10
false
EKS/AKS 上的 Automation Suite 安装指南
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。

在 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 仪表板的备份。但是,所有历史数据均已成功备份。

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

要准备升级,请执行以下步骤:

  1. 请查看兼容性矩阵,以确定每个可用升级方案的受支持版本。如果您自带组件,请确保组件的版本与您计划升级到的版本兼容。有关详细信息,请参阅兼容性矩阵。
  2. 在管理计算机上下载适用于要升级到的版本的versions.json和uipathctl 。有关下载说明,请参阅“下载安装包” 。
  3. 生成最新的input.json文件,如下所示:
    • 选项 A:要获取input.json文件的最新修订,请运行以下命令:
      uipathctl manifest get-revision
      uipathctl manifest get-revision
      
    • 选项 B:要列出所有过去的input.json文件并确定要选择的文件,请运行以下命令:
      uipathctl manifest list-revisions
      uipathctl manifest list-revisions
      
  4. 如果您使用离线设置与符合 OCI 的外部注册表,则必须在升级前将注册表与容器映像和 Helm 图表结合使用。有关详细信息,请参阅使用离线捆绑包结合使用注册表。
  5. 如果已安装 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™ 服务和组件,请执行以下步骤

  1. 确认您的集群运行状况良好:
    uipathctl health check
    uipathctl health check
    
  2. 将集群置于维护模式以保证备份一致性:
    uipathctl cluster maintenance enable
    uipathctl cluster maintenance enable
    
    重要提示:

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

  3. 要验证集群是否处于维护模式,请运行以下内容:
    uipathctl cluster maintenance is-enabled
    uipathctl cluster maintenance is-enabled
    
  4. 备份集群和 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 集成身份验证
  5. 禁用维护模式:
    uipathctl cluster maintenance disable
    uipathctl cluster maintenance disable
    
    备注:

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

  6. 升级 UiPath™ 服务和组件:
    uipathctl cluster upgrade input.json --versions versions.json
    uipathctl cluster upgrade input.json --versions versions.json
    
    重要提示:

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

  7. 升级后检查集群是否运行正常:
    uipathctl health check
    uipathctl 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 基础架构。

  • 升级 UiPath™ 服务和组件​
  • 准备​
  • 执行​
  • 升级 Kubernetes 基础架构​

此页面有帮助吗?

连接

需要帮助? 支持(opens in new window)

想要了解详细内容? UiPath Academy(opens in new window)

有问题? UiPath 论坛(opens in new window)

保持更新