完成升级

上下文

执行 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>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)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 模型，但该设置不会应用于较旧的实例。
有关您可能遇到的升级错误的详细信息，请参阅手动：在线升级和自动：在线升级。

执行

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

从此处下载 upgradeUiPathAS.sh 脚本。
导航到下载脚本的路径，然后运行以下命令：chmod +x ./upgradeUiPathAS.sh。
在 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 模板版本不同。