完成升级

Context

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

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

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

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

准备

先决条件

确保满足以下要求：

• 您必须将与部署关联的托管服务身份 (MSI)（名称为 <basename>-MSI）作为用户分配的身份添加到部署中的所有规模集/虚拟机。为此，请转到“规模集/虚拟机”>“身份”>“用户分配”>“添加”。较新版本的 Automation Suite 模板可能已添加此内容。
• 您必须授予现有 MSI 权限，以读取/写入/管理已部署的密钥保管库（名称为 <basename>-VAULT）中的密码。为此，请转到密钥保管库，单击“访问策略”，然后单击“添加”，选择所有“密码操作”，选择“MSI”，然后单击“添加”。
• 请务必查看 cluster_config.json 文件，并将标记为字符串 ("true"/"false") 的所有布尔值更改为实际的布尔值 (true/false)。例如：
  • 要启用区域恢复，请使用 "zone_resilience": true。
  • 要允许安装程序创建数据库，请使用 "sql.create_db": true。
• 确保虚拟机规模集（服务器、代理等）的 RHEL 版本已更新，并且与要升级到的版本相符。
• 如果从 Automation Suite 2022.10 升级到 Automation Suite 2023.4 或更高版本，并且新旧版本中都启用了 Orchestrator，则必须在 cluster_config.json 文件中将 orchestrator.block_classic_executions 标志设置为 true。使用该标志即表示您同意阻止传统文件夹执行。不使用该标志会导致升级操作失败。新安装中不需要此参数。
• 如果您升级到 Automation Suite 2023.10 或更高版本，并且在新旧环境中都启用了 Insights，则必须将 insights.external_object_storage.bucket_name 标志设置为 cluster_config.json 文件中 platform 使用的相同存储桶。不使用该标志会导致升级操作失败。新安装中不需要此参数。
• 升级到 Automation Suite 2023.10 或更高版本时，如果将 sql.create_db 设置为 true，请在 cluster_config.json 中填写以下字段：

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>

• 升级流程完成后，将新的 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 角色。

注意事项和建议

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

• 我们强烈建议更新到 Automation Suite 支持的最新 RHEL 操作系统版本。有关详细信息，请参阅硬件和软件要求。
• 在开始升级操作之前，您可以在部署存储帐户（名为 <basename>st）中创建两个名为 logs 和 flags 的容器。如果您不创建这些容器，升级脚本可以为您执行此操作。
• 如果已部署的服务器规模集没有附加 Ceph 磁盘，则脚本会创建一个 Ceph 磁盘并将其附加到服务器规模集。
• 升级流程会更改 VMSS 模型，但该设置不会应用于较旧的实例。
• 对使用 Azure 模板部署的集群执行升级时，可能会出现类似于下图所示的错误：
  
  

  

  
  
  这是由 Azure 负载均衡器的工作方式所造成。要解决此问题，请修改 cluster_config.json 文件中的 fixed_rke_address 字段。在运行升级命令之前，您必须将此字段的值更改为第一个服务器实例的 IP 地址。由于节点运行状况不佳，上传到密钥保管库的 cluster_config.json 应继续具有 ILB 的 IP 地址，并且不会平衡到该节点的流量。

执行

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

1. 从此处下载 upgradeUiPathAS.sh 脚本。
2. 导航到下载脚本的路径，然后运行以下命令：chmod +x ./upgradeUiPathAS.sh。
3. 在 Linux 环境中以交互或非交互模式运行升级过程：

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

     sh upgradeUiPathAS.sh --targetVersion {ASversion}

     该脚本会要求您在运行期间提供一系列参数。 有关所需参数的详细信息，请参阅将 Automation Suite 部署到 Azure。

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

     1. 在下载的脚本旁创建一个 <targetVersion> 文件夹。
     2. 在 <targetVersion> 文件夹中，使用以下结构创建一个名为 paramValues.json 的文件：
        { "param1":"value1", "param2":"value2" }。

        有关所需参数的详细信息，请参阅将 Automation Suite 部署到 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 文件。