Orchestrator 構成ツールを使用する

Orchestrator 構成ツールは、Automation Suite の Orchestrator デプロイ内でのファイルの配置や設定を可能とする bash スクリプトです。このツールは、ストレージ ファイル、資格情報ストア プラグイン、NLog 拡張機能、新しい NLog 構成の追加、ならびに appSettings の上書きを支援します。

Orchestrator 構成ツールを使用する環境は、bash スクリプトが実行可能で、以下のツールを備えている必要があります。

• クラスターへの接続が構成された kubectl

• jq 1.6

• rclone

  注:

  Follow these steps to install 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.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.json -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.json

appsettings.json ファイルがまだ存在しない場合は、次の例に示すように自分で作成できます。

{
    "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"
        }
      }
    }
  }
}