更新 Orchestrator 配置

更新 Orchestrator 配置。请务必查看以下内容：

来自 UiPath.Orchestrator.dll.config 的自定义配置
任何 web.config 设置。
存储（包、执行介质和存储桶数据）- 主要适用于 Storage.Type=FileSystem
自定义 NLog 目标。
自定义凭据存储。
为每个租户配置的加密密钥。

您可以使用提供的 Orchestrator 配置程序工具简化以下许多步骤。

orchestrator_configurator.sh Bash 工具可以更新 Orchestrator 自定义配置映射并将文件上传到 Orchestrator 已知 Blob 存储位置。使用 -y 参数跳过对建议操作的确认。

配置 web.config

使用 Lens 或 kubectl 等工具编辑 orchestrator-customconfig 配置映射。

在 values.json 文件中配置请求限制。更改此配置后，Orchestrator 部署应自动重新启动。

{
  "Kestrel": {
    "Limits": {
      "MaxRequestBodySize": 314572800
    }
  }{
  "Kestrel": {
    "Limits": {
      "MaxRequestBodySize": 314572800
    }
  }

配置应用程序设置

在预迁移步骤中编辑的 appSettings.custom.json 文件现在包含 appSettings 部分中所需的所有自定义。您需要将此 .json 文件放置在 orchestrator-customconfig 配置映射中的 values.json文件中，位于 appSettings 键下。

{
    "ExampleSetting.Enabled": true,
    "ExampleSetting.Type": "BasicExample",
    "ExampleSetting.Count": 3
}{
    "ExampleSetting.Enabled": true,
    "ExampleSetting.Type": "BasicExample",
    "ExampleSetting.Count": 3
}

Orchestrator 配置程序工具可以将自定义应用程序设置中的键与配置映射中已存在的键合并。您可以使用 -c|--app-settings 参数上传应用程序设置：

./orchestrator-configurator.sh -c appSettings.custom.json./orchestrator-configurator.sh -c appSettings.custom.json

如果使用配置器工具，请完成所有步骤以收集所有必需的应用程序设置覆盖，并在最后运行一次脚本。

配置存储

如果您使用的是本地文件存储，并且需要将现有存储内容上传到 Orchestrator，请确保将其放置在 /var/orchestator/data 路径下的任何 Orchestrator Pod 中。

Orchestrator 配置程序可以使用 -s|--storage-folder 参数通过 kubectl cp 上传文件：

./orchestrator-configurator.sh -s blobstoragefolder./orchestrator-configurator.sh -s blobstoragefolder

该脚本可确保 storage 文件夹的内容成为 /var/orchestrator/data 文件夹的内容。

要使用网络文件存储，请编辑 Orchestrator ArgoCD 应用程序参数并设置以下内容：

storage.type = smb
storage.smb.domain
storage.smb.password
storage.smb.source
storage.smb.username
storage.smb.size

要配置其他存储选项，请编辑 Orchestrator ArgoCD 应用程序参数并设置以下内容：

storage.type 到所需的提供程序 (Azure、AWS、 Minio)
storage.connectionString

Orchestrator 应用程序存储设置概述：

Azure/Amazon S3 存储桶

由于提供程序端的同源策略，Orchestrator 网页浏览器对 Amazon 和 Azure 存储桶的访问可能会受到限制。要成功访问此类存储桶的内容，您需要配置相应的提供程序以允许来自 Orchestrator 的跨域请求。

请参阅有关如何配置每个提供程序以允许来自 Orchestrator 的跨域请求的说明。

配置 NLog

要安装 NLog 扩展程序，需要将其复制到 uipath 存储桶中的 Ceph 中。然后，Orchestrator Pod 将能够在启动时加载它们。您还需要将配置放入 nlog.json 文件的 orchestrator-customconfig 中。

配置程序可以使用 -n|--nlog-extensions-folder 和 -l|--nlog-config-file 参数执行此操作。

./orchestrator-configurator.sh -n nlogextensions -l nlog.custom.json./orchestrator-configurator.sh -n nlogextensions -l nlog.custom.json

插件将在 Orchestrator Pod 的本地路径 /var/orchestrator/plugins/nlog 中可用。配置程序会自动更新程序集文件路径，并在其中添加插件路径。

配置凭据存储

凭据存储配置更改包含在 appsettings.custom.json 中，因此不再需要配置更新。

要手动进行更改，请将其放置在 orchestrator-customconfig 的 values.json 文件中的应用程序设置部分下。

如果还需要安全存储程序集，则必须将它们放置在 /var/orchestrator/plugins/securestore/ 路径的任何 Orchestrator Pod 中。

Orchestrator 配置程序工具可以使用 -p|--securestore-plugins-folder 参数执行此操作：

./orchestrator-configurator.sh -p securestoreplugins./orchestrator-configurator.sh -p securestoreplugins

配置加密密钥

要配置加密密钥，请将其替换为 Kubernetes 密码 orchestrator-generated-secrets，方法是覆盖 APPSETTINGS__EncryptionKey 的值。为此，请运行以下命令：

ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"

注意：确保将 <key> 替换为从 UiPath.Orchestrator.dll.config 中检索到的键的值。

为每个租户配置加密密钥

要迁移每个租户的加密密钥，请执行以下步骤：

在 ArgoCD 用户界面中添加 AzureKeyVault 设置和证书，作为 Orchestrator 应用程序的参数覆盖。
- encryptionKeyPerTenant.certificateBase64
- encryptionKeyPerTenant.certificatePassword
- encryptionKeyPerTenant.clientId
- encryptionKeyPerTenant.directoryId
- encryptionKeyPerTenant.vaultAddress
1. 使用以下配置键中的值（在准备步骤中引用）：
  - Azure.KeyVault.VaultAddress
  - Azure.KeyVault.ClientId
  - Azure.KeyVault.DirectoryId
2. 将证书转换为 Base64 并将其用作参数覆盖。要进行转换，请使用以下命令：
  PowerShell：
```
[convert]::ToBase64String((Get-Content -path "path_to_certificate" -Encoding byte))[convert]::ToBase64String((Get-Content -path "path_to_certificate" -Encoding byte))
```
  Shell：
```
base64 [_path_to_certificate_]base64 [_path_to_certificate_]
```
应用 Orchestrator ArgoCD 应用程序参数覆盖，然后运行 Orchestrator 配置程序工具。
一旦新配置反映在 ArgoCD 中，请等待，直至应用程序再次同步。
启用 EncryptionKeyPerTenant 功能，如下所示：
- 使用 appSettings.custom.json 中的两个设置并运行 Orchestrator 配置程序工具；
- 或在 orchestrator-customconfig、values.json 文件的 appConfig 部分中手动添加。
```
"EncryptionKeyPerTenant.Enabled": "true", "EncryptionKeyPerTenant.KeyProvider": "AzureKeyVault","EncryptionKeyPerTenant.Enabled": "true", "EncryptionKeyPerTenant.KeyProvider": "AzureKeyVault",
```
从集群重新启动 Orchestrator Automation Suite 部署以使更改生效。

注意：Identity Server 中的 SMTP 设置未使用每个租户的密钥进行加密。迁移完成后，请确保在 Automation Suite 门户中重新输入 SMTP 密码。