执行升级

执行 Automation Suite 集群升级，包括维护模式、备份步骤和升级过程。

重要提示：

要执行 Automation Suite 升级，您必须将集群置于维护模式。维护模式会导致整个升级过程停机，在此期间您的业务自动化将暂停。 强烈建议在升级 AI Center 之前创建集群和 SQL 数据库的备份。这是为了确保您可以在升级操作期间出现问题时还原集群。

要执行升级，您必须执行以下步骤：

1. 运行先决条件检查。
2. 配置备份。
3. 禁用备份。
4. 将集群置于维护模式。
5. 将 Longhorn 工作负载、MongoDB 数据和 Ceph 迁移到基于 Helm 的部署。
6. 更新 Kubernetes 和其他基础架构组件。
7. 升级共享组件 和 UiPath™ 服务。

运行先决条件检查

在将集群置于维护模式之前，您必须验证是否满足所有升级要求。

1. 使用以下命令运行基础架构先决条件检查：

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json
   

2. 使用以下命令运行共享组件和服务先决条件检查：

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json
   

备注：

如果您当前的 Automation Suite 版本使用大写 FQDN，先决条件检查将失败，并显示一条消息，要求您切换到小写 FQDN。在这种情况下，请将 FQDN 更新为小写，然后再继续升级。有关说明，请参阅“安装后配置 FQDN” 。

配置备份

要配置备份，请执行以下步骤：

1. 确保您在集群上启用了备份。您必须使用与当前部署所用版本相同的安装程序版本创建备份。

   有关详细信息，请参阅与您计划升级的 Automation Suite 版本相对应的备份和还原文档。例如，如果您计划从 Automation Suite 2023.4 升级，请参阅2023.4 指南。

2. 通过 SSH 连接到其中一个服务器节点。

3. 验证集群中是否所有所需的卷都有备份：

   • 如果您从 2022.4 或更早版本升级，请运行以下命令：

     /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
     

   • 如果从 2022.10 或更高版本升级，请运行以下命令：

     ./configureUiPathAS.sh snapshot list
     

   • 如果从 2024.10 或更高版本升级，请运行以下命令：

     ./bin/uipathctl snapshot list
     

备注：

备份可能需要一些时间，因此请等待大约 15 至 20 分钟，然后再次验证卷备份。

创建备份后，请继续执行以下步骤。

备注：

从 23.10.0 或更高版本升级时，请确保使用目标版本目录中的uipathctl命令。

禁用备份

在将集群置于维护模式之前，您必须禁用备份，以避免在次优状态下备份集群。有关详细信息，请参阅禁用快照备份。

将集群置于维护模式

将集群置于维护模式将关闭入口控制器和所有 UiPath™ 服务，并阻止所有流入 Automation Suite 集群的流量。

1. 要将集群置于维护模式，请运行：

   ./bin/uipathctl cluster maintenance enable
   

2. 要验证集群是否处于维护模式，请运行：

   ./bin/uipathctl cluster maintenance is-enabled
   

执行升级前迁移操作

运行以下必需的升级前命令：

./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions

此命令有选择地将 Longhorn 工作负载迁移到本地 PV，将 MongoDB 数据迁移到 SQL，并将 Ceph 部署从 ArgoCD 迁移到基于 Helm 的部署。

更新 Kubernetes 和其他基础架构组件

要升级 Kubernetes 和其他基础架构组件，请在主服务器节点上运行以下命令：

重要提示：

确保您按照更新集群配置中的说明更新了生成的 cluster_config.json 文件。

备注：

由于从 Automation Suite 2.2510.0 开始 Task Mining 不再可用，如果您有专用 Task Mining 节点，则可以按照“从集群中删除节点”中的说明将其从集群中删除。

如果要在 Automation Suite 中重用节点，可以通过运行以下命令来删除污点：

kubectl taint nodes <nodename> task.mining/cpu=present:NoSchedule-

cd /opt/UiPathAutomationSuite/latest/installer

./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json

备注：

• 在主服务器节点上运行上一个命令会将安装程序和 cluster_config.json 复制到 /opt/UiPathAutomationSuite/<version>/installer 默认位置，并升级所有计算机上的基础架构。

• /opt/UiPathAutomationSuite/<version>默认位置的所有节点必须至少有 5 GB 的可用空间。

• 要更改默认位置，请使用所需位置更新以下环境变量。确保该位置在所有节点上可用，并且具有运行升级所需的权限。

  export INSTALLER_DIRECTORY=/path/to/copy/installer
  

• 执行上一个命令并运行升级后，系统会将安装程序文件复制到 /path/to/copy/installer/<version>/installer 位置。将 version 替换为您执行的安装程序的版本。

故障排除

• 除非您明确为安装程序使用了自定义位置，否则主服务器上的升级日志可在 /opt/UiPathAutomationSuite/latest/installer/upgrade-logs 默认位置中找到。
• 在所有其他节点上，日志位于 /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs 默认位置，除非您通过 INSTALLER_DIRECTORY 变量显式更改了此位置。

升级共享组件和 UiPath™ 服务

1. 如果您启用了 Insights，则必须运行以下命令，以确保在升级后保留 Insights 数据：

   kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -
   

   备注：

   如果未启用 Insights，运行此命令不会产生任何负面影响。

2. 要升级共享组件和 UiPath™ 产品服务，请在主服务器节点上运行以下命令：

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json
   

   重要提示：

   完成升级后，系统将自动禁用维护模式。

3. 要验证 Automation Suite 是否运行正常，请运行以下命令之一：

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl health check
   

   备注：

   如果找不到helm-charts.json ，也可以使用versions.json 。要下载versions.json ，请参阅下载安装包。

完成升级后，执行适合您的清理和迁移活动。