自动化：离线升级

Ansible 用于通过在集群中的一台计算机上执行某些操作来自动升级整个 Automation Suite 集群。

在下图中， 服务器 1 节点（或 Ansible 主机节点）使用 Ansible 协调整个 Automation Suite 集群的升级。

准备

重要提示：

升级之前，请确保已为使用 uipathctl.sh 脚本准备好环境。 有关详细信息，请参阅 使用 uipathctl.sh。

确保所有节点上的/opt/UiPathAutomationSuite文件夹中都有 10GiB 的可用空间。 如果空间不足，您可以增加此文件夹的容量，也可以删除除cluster_config.json之外的所有以前的安装程序文件。 您始终可以再次下载以前的安装程序。

要验证可用空间，请运行以下命令： df -h /opt/UiPathAutomationSuite 。

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

1. 通过 SSH 登录到先前标识为 Ansible 主机节点 的服务器节点。 确保您已选择在 /uipath 处附加了 UiPath 捆绑包附加磁盘的主服务器节点作为 Ansible 主机节点。
2. 成为根用户:

   sudo su -

3. 在/opt/UiPathAutomationSuite目录下创建安装文件夹：

   # Please replace {version} with installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer

4. 下载 sf-installer.zip 并将其复制到 /opt/UiPathAutomationSuite/{version}/installer。 有关下载说明，请参阅 sf-installer.zip。

   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer

5. 解压缩sf-installer.zip :

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip sf-installer.zip -d .

6. 下载 sf-infra.tar.gz 并将其复制到 /uipath/{version}。 有关下载说明，请参阅 sf-infra.tar.gz。

   cp /path/to/sf-infra.tar.gz /uipath/{version}

7. 下载 sf.tar.gz 并将其复制到 /uipath/{version}。有关下载说明，请参阅 sf.tar.gz。

   cp /path/to/sf.tar.gz /uipath/{version}

8. 为安装程序提供必要的权限：

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer

9. 在 Ansible 主机节点上生成最新的cluster_config.json文件。
   注意：有关如何配置 cluster_config.json 参数的详细信息，请参阅高级安装体验。

   • 如果您有旧的cluster_config.json ，请从集群生成配置文件：

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json

   • 如果您没有旧的cluster_config.json文件，请生成任何默认值的覆盖，您可能在以前的版本安装时已完成此操作：

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -o ./cluster_config.json

执行

重要提示：

如果在升级期间或升级后发生任何错误或问题，您可以回滚到以前的版本，前提是您之前配置了备份。

有关说明，请参阅出错时回滚。

配置备份

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

1. 确保您在集群上启用了备份。您必须使用与当前部署所用版本相同的安装程序版本创建备份。有关说明，请参阅与您计划升级的 Automation Suite 版本对应的备份和还原文档。例如，如果您计划从 Automation Suite 2021.10 进行升级，请按照 2021.10 指南中的说明进行操作。
2. 通过 SSH 登录到先前标识为 Ansible 主机节点 的服务器节点。
3. 验证集群中是否所有所需的卷都有备份：

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

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

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

将集群置于维护模式

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

重要提示：此操作将导致停机，并且在整个升级过程中，您的业务自动化将暂停。

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

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode

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

   ./configureUiPathAS.sh is-maintenance-enabled

   重要提示：启用维护模式后，请创建 SQL Server 的备份，以便 SQL 数据库不再记录任何事务。

升级集群

要升级 Automation Suite 集群，请执行以下步骤：

1. 通过 SSH 连接到 Ansible 主机节点并成为根用户。
2. 要在所有节点上执行升级步骤，请使用基本参数运行以下命令。 如需更精细的控制，请参阅参数部分。
   注意：请确保已按照准备步骤中的说明更新生成的 cluster_config.json。

   # Please replace {version} with installer version, in all the below commands
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type offline --steps all --offline-bundle /uipath/{version}/sf.tar.gz --offline-infra-bundle /uipath/{version}/sf-infra.tar.gz --accept-license-agreement

   重要提示：

   升级过程需要从 Canal CNI 迁移到 Cilium CNI。 自动升级会自动执行此步骤，然后重新启动集群中的所有节点以完成迁移。

   重新启动节点后，请等待几分钟，以确保所有服务再次联机。 您可以登录 ArgoCD 以监控所有应用程序的状态。

   重要提示：

   如果收到以下错误，请按照将 Ceph 从 16.2.6 降级到 15.2.9中的说明进行操作。

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

基本参数

参数	值
--install-type	可能的值： online和offline 。 由于此页面提供了有关离线环境的说明，因此请选择offline值。
--steps	可能的值包括： all 、 infra 、 fabric和services 。 表示安装和升级流程的每个阶段。 all – 推荐：所有其他步骤的超集，用于升级整个 Automation Suite。 infra – 升级所有节点上 Automation Suite 上的 Kubernetes 和其他基础架构组件。 bundles – 上传 Automation Suite 集群中托管的 Docker 注册表，并使用结构和服务容器映像对其进行水合。 重要提示： 您必须在升级 Kubernetes 和基础架构组件的同时上传 Docker 注册表并进行水合。 要同时执行这两个步骤，请运行 --steps bundles infra。 请勿单独运行， --steps bundles 因为它会损坏集群。 fabric – 升级 Automation Suite 的所有结构和共享组件。 services – 升级 Automation Suite 上安装的所有 UiPath 产品服务。 如果升级期间发生错误，您可以使用这些检查点恢复升级操作，而不是从头开始重试。
--offline-bundle	sf.tar.gz 离线捆绑包的路径，其中包含结构和服务容器映像。 建议将其存储在 `/uipath/{version
--offline-infra-bundle	sf-infra.tar.gz离线捆绑包的路径，其中包含 Kubernetes 和基础架构捆绑包。
--cluster-config	cluster_config.json 文件，定义应用于通过 Automation Suite 部署的 UiPath 服务的参数、设置和首选项。

高级参数

参数	值
--ansible-username	指定用于与所有节点的 SSH 连接的用户名。 默认为当前用户。 如果您对所有节点使用不同的用户名，则不要使用此参数，而是在inventory.ini中设置所有节点的用户名，并将其传递给脚本。 示例： 运行脚本时，您将以myadminuser用户名登录。 但是，如果要使用testadmin用户名通过 SSH 连接，则必须为此参数提供testadmin 。
--inventory	指定现有的 Ansible 清单文件。 如果未指定，系统将使用基本配置从现有集群自动生成一个。 在某些情况下，您希望进行更精细的控制，您可能需要提供自己的清单文件。 例如，如果您想对集群中的所有节点使用不同的 SSH 用户名或 SSH 密钥。 有关详细信息，请参阅 生成 AnsibleInventory.init 文件。

备注：

如果升级由于任何原因失败，但已成功上传到 Docker 注册表，则无需重新上传。 您可以通过直接运行架构或服务安装来恢复升级： ./uipathctl.sh upgrade --install-type offline --steps {fabric | services} 。

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

执行升级后，您可以执行以下附加步骤：

• 要验证 Automation Suite 是否运行正常，请运行：

  kubectl get applications -n argocd

• 如果在执行升级后遇到映像漏洞或存储消耗问题，请从旧的安装程序中删除映像。有关详细信息，请参阅故障排除部分。

启用升级后备份

注意：请确保 Automation Suite 已启动并正在运行，且您的自动化按预期继续进行，然后再继续执行后续步骤。

在开始升级集群之前，升级脚本会自动创建集群的备份，然后暂时将其禁用。 升级完成后，您可能需要手动启用备份。

要启用备份，请从任何服务器节点运行以下命令：

# replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh resume-scheduled-backups