完成升级

Context

执行 Automation Suite 集群升级后，需要进行一些更改，以确保新节点正确加入集群。要自动执行更改，我们建议使用 upgradeUiPathAS.sh 脚本。

本页面提供有关如何替换计算资源上的自定义脚本扩展 (CSE) 的说明，以便在升级到新的 Automation Suite 版本时可以将新节点添加到集群中。

以下部分中描述的流程会下载相关脚本，该脚本需要对 Azure 资源执行一些细微修改，以及验证一些先决条件。这些脚本位于 <targetVersion> 和 Modules 文件夹中。如果流程失败，系统将询问您是否要保留文件。

确保先决条件有效后，系统会更新所有计算资源上的 CustomScriptExtension 对象，以便新添加的节点使用 Automation Suite <targetVersion>。最后，系统会覆盖初始集群节点上的文件，以同样匹配 <targetVersion> 中的文件。

准备

先决条件

确保满足以下要求：

• 您必须将与部署关联的托管服务身份 (MSI)（名称如<basename>-MSI ）作为用户分配的身份添加到部署中的所有规模集/虚拟机。为此，请转到“规模集/虚拟机” > “身份” > “用户分配” > “添加” 。较新版本的 Automation Suite 模板可能已添加此内容。

• You must grant the existing MSI rights to read/write/manage secrets in the deployed key vault (named like <basename>-VAULT). To do this, go to the keyvault, click Access Policies, then Add, select all Secret Operations, choose the MSI, then Add.

• 请务必查看 cluster_config.json 文件，并将标记为字符串 ("true"/"false") 的所有布尔值更改为实际的布尔值 (true/false)。例如：

  备注：

  如果从 Automation Suite 2022.10 升级到 Automation Suite 2023.4 或更高版本，并且新旧版本中都启用了 Orchestrator，则必须在 cluster_config.json 文件中将 orchestrator.block_classic_executions 标志设置为 true。使用该标志即表示您同意阻止传统文件夹执行。不使用该标志会导致升级操作失败。新安装中不需要此参数。

  • 要启用区域恢复，请使用 "zone_resilience": true。
  • 要允许安装程序创建数据库，请使用 "sql.create_db": true。

• 升级流程完成后，将新的 cluster_config.json 文件内容导出到部署密钥保管库中名为 clusterConfig 的 Azure 密钥保管库密码（有关详细信息，请参阅上一个列表项目）。使用 FixedRKEAddress 字段的值作为内部负载均衡器的 IP。为完成此操作，请运行类似于以下内容的命令：

  az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json)
  

• 在运行升级脚本的计算机上，您必须登录到 Azure 并将上下文设置为正确的订阅。该帐户必须在部署集群的资源组上具有 Owner 角色。

注意事项和建议

在开始升级操作之前，请务必考虑以下建议：

• We strongly recommend updating to the latest RHEL OS version supported by Automation Suite. For details, see Deployment profiles at a glance.
• 在开始升级操作之前，您可以在部署存储帐户（名为 <basename>st）中创建两个名为 logs 和 flags 的容器。如果您不创建这些容器，升级脚本可以为您执行此操作。
• 如果已部署的服务器规模集没有附加 Ceph 磁盘，则脚本会创建一个 Ceph 磁盘并将其附加到服务器规模集。
• 升级流程会更改 VMSS 模型，但该设置不会应用于较旧的实例。
• For details on the upgrade errors you might encounter, see Manual: Online upgrade and Automated: Online upgrade.

执行

要成功执行升级到新的 Automation Suite 版本，请执行以下步骤：

1. 从此处下载upgradeUiPathAS.sh脚本。

2. 导航到下载脚本的路径，然后运行以下命令：chmod +x ./upgradeUiPathAS.sh。

3. 在 Linux 环境中以交互或非交互模式运行升级过程：

   • 选项 A ：要以交互模式运行流程，请使用以下命令：

     sh upgradeUiPathAS.sh --targetVersion {ASversion}

     The script asks you to provide a series of parameters during the run. For details on the required parameters, see Deploying Automation Suite to Azure.

   • 选项 B：要以非交互模式运行流程，请执行以下步骤：

     1. 在下载的脚本旁创建一个 <targetVersion> 文件夹。

     2. 在 <targetVersion> 文件夹中，使用以下结构创建一个名为 paramValues.json 的文件：

        { "param1":"value1", "param2":"value2" }。

        For details on the required parameters, see Deploying Automation Suite to Azure.

     3. 运行 upgradeUiPathAS.sh 脚本：

        sh upgradeUiPathAS.sh --targetVersion {ASversion} --uninteractive true

        备注：

        确保在上述命令中将{ASversion}替换为 Automation Suite 版本。Automation Suite 版本可能与 Azure 模板版本不同。

参数

您可以在cluster_config.json文件中找到更新到特定 Automation Suite 版本所需参数的说明。您可以在此链接中找到cluster_config.json文件。