Uso de la herramienta de configuración de Orchestrator

La herramienta de configuración de Orchestrator es un bash script que permite colocar archivos y configuraciones dentro de la implementación de Orchestrator en Automation Suite. appSettingsLa herramienta le ayuda a añadir archivos de almacenamiento, plugins de almacenamiento de credenciales, extensiones de NLog, nuevas configuraciones de NLog y anulación de .

El entorno en el que se utiliza la herramienta de configuración de Orchestrator debe ser capaz de ejecutar un bash script y disponer de las siguientes herramientas:

• kubectl configurado con una conexión al clúster
• jq 1.6

• rclone

  Nota: Siga estos pasos para instalar rclone.

Importante:

No descargues ni utilices la herramienta ArgoCD CLI de forma independiente. Para mantener la compatibilidad y garantizar un funcionamiento sin problemas, recomendamos utilizar el ArgoCD que incluimos en los artefactos de Automation Suite. Para ello, debes añadir ArgoCD a tu ruta desde el último instalador ejecutando el siguiente comando:

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

Para poder ejecutar la herramienta de configuración de Orchestrator desde cualquier ubicación, sigue estos pasos:

1. Actualiza la variable PATH para incluir <installer-dir>/Tools. Por ejemplo:

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

2. Asegúrate de que la versión de la utilidad jq --version es 1.6.Si no es así, actualiza la opción mediante una de estas opciones:
   • Opción 1:

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

   • Opción 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

Ejemplo:

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 la nueva configuración de la aplicación, ejecuta el siguiente comando:

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

Ejemplo appsettings.custom.config

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

Para cambiar la configuración de NLog, ejecuta el siguiente comando:

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

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