使用 Orchestrator 配置程序工具

Orchestrator 配置程序工具是一个 bash 脚本，可用于将文件和设置放置在 Automation Suite 的 Orchestrator 部署中。该工具可帮助您添加存储文件、凭据存储插件、NLog 扩展程序、新的 NLog 配置并覆盖 appSettings。

使用 Orchestrator 配置程序工具的环境必须能够运行 bash 脚本并具有以下工具：

• kubectl 配置了与集群的连接
• jq 1.6

• rclone

  注意：请按照以下步骤安装 rclone。

重要提示：

不要独立下载和使用 ArgoCD CLI 工具。为了保持兼容性并确保顺利运行，我们建议使用我们在 Automation Suite 工件中捆绑的 ArgoCD。为此，您必须通过运行以下命令将 ArgoCD 添加到最新安装程序的路径中：

export PATH="$PATH:/opt/UiPathAutomationSuite/<version>/installer/bin"

为了能够从任何位置运行 Orchestrator 配置程序工具，请按照以下步骤操作：

1. 更新PATH变量以包含<installer-dir>/Tools 。 例如：

   export PATH="$PATH:/opt/UiPathAutomationSuite/online_installer_<version>/Tools"

2. 确保jq --version实用程序版本为 1.6。 如果不是，请通过以下选项之一进行更新：
   • 选项 1：

     yum install -y epel-release
     yum install -y jq

   • 选项 2：

     curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
     yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm
     jq --version

示例：

Usage: ./orchestrator_configurator.sh \
  -s blobstoragefolder -p pluginsfolder -n nlogextensionsfolder \
  -c appsettings.custom.config -l nlog.custom.config 

    -c|--app-settings
        application configuration file containing json with key-value structure
    -l|--nlog-config-file
        nlog config file, json

    -s|--storage-folder
        location of the storage folder on the local disk
    -n|--nlog-extensions-folder
        location of the nlog extensions on the local disk
    -p|--securestore-plugins-folder
        location of the securestore plugins on the local disk

    -d|--dry-run
        do not update the orchestrator app with the new values
    -y|--accept-all
        do not prompt for confirmation of actions and overwriting of files with kubectl cp.

要应用新的应用程序设置，请运行以下命令：

./orchestrator_configurator.sh -c appsettings.custom.json

appsettings.custom.config 示例

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

要更改 NLog 配置，请运行以下命令：

./orchestrator_configurator.sh -l nlog.custom.json

nlog.custom.config 示例

{
  "Nlog": {
    "targets": {
      "robotElasticBuffer": {
        "flushTimeout": 1000,
        "bufferSize": 1000,
        "slidingTimeout": false,
        "target": {
          "uri": "https://elastic.example.com:9200",
          "requireAuth": true,
          "username": "elastic-user",
          "password": "elastic-password",
          "index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
          "documentType": "logEvent",
          "includeAllProperties": true,
          "layout": "${message}",
          "excludedProperties": "agentSessionId,tenantId,indexName"
        }
      }
    }
  }
}