Uso da ferramenta de configuração do Orchestrator

A ferramenta de configuração do Orchestrator é um script de bash que permite que você coloque arquivos e configurações dentro da implantação do Orchestrator no Automation Suite. A ferramenta ajuda você a adicionar arquivos de armazenamento, plug-ins do repositório de credenciais, extensões do NLog, novas configurações do NLog, e substituir o appSettings.

O ambiente no qual você usar a ferramenta de configuração do Orchestrator deve permitir a execução de um script de bash e ter as seguintes ferramentas:

• kubectl configurado com uma conexão ao cluster
• jq 1.6

• rclone

  Observação: siga estas etapas para instalar o rclone.

Importante:

Não baixe e use a ferramenta ArgoCD CLI de forma independente.Para manter a compatibilidade e garantir uma operação tranquila, recomendamos usar o ArgoCD que acrescentamos aos artefatos do Automation Suite. Para fazer isso, você deve adicionar o ArgoCD ao seu caminho a partir do instalador mais recente executando o seguinte comando:

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

Para poder executar a Ferramenta de configuração do Orchestrator a partir de qualquer local, siga estas etapas:

1. Atualize a variável PATH de modo a incluir <installer-dir>/Tools. Por exemplo:

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

2. Certifique-se de que a versão do utilitário jq --version seja 1.6. Se não for, atualize-o usando uma destas opções:
   • Opção 1:

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

   • Opção 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

Exemplo:

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.

Para aplicar novas configurações de aplicativo, execute o seguinte comando:

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

Exemplo appsettings.custom.config

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

Para alterar a configuração do NLog, execute o seguinte comando:

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

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