Utilisation de l'outil Orchestrator Configurator

L'outil Orchestrator Configurator est un script bash qui vous permet de placer des fichiers et des paramètres dans le déploiement d'Orchestrator dans Automation Suite. L'outil vous aide à ajouter des fichiers de stockage, des plug-ins de magasin d'informations d'identification, des extensions NLog, de nouvelles configurations NLog et permet de remplacer les appSettings.

L'environnement dans lequel vous utilisez l'outil Orchestrator Configurator doit pouvoir exécuter un script bash et disposer des outils suivants :

• kubectl configuré avec une connexion au cluster
• jq 1.6

• rclone

  Remarque : suivez ces étapes pour installer rclone.

Important :

Ne téléchargez pas et utilisez l’outil ArgoCD CLI indépendamment. Pour maintenir la compatibilité et assurer un fonctionnement fluide, nous vous recommandons d’utiliser l’ArgoCD que nous regroupons dans les artefacts Automation Suite. Pour ce faire, vous devez ajouter ArgoCD à votre chemin d’accès à partir du dernier programme d’installation en exécutant la commande suivante :

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

Pour pouvoir exécuter l’Outil de configuration d’Orchestrator à partir de n’importe quel emplacement, procédez comme suit :

1. Mettez à jour la variable PATH afin d'inclure <installer-dir>/Tools . Par exemple :

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

2. Assurez-vous que la version de l'utilitaire jq --version est bien la 1.6. Si ce n'est pas le cas, mettez-le à jour via l'une des options suivantes :
   • Option 1 :

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

   • Option 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

Exemple :

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.

Pour appliquer les nouveaux paramètres de l'application, exécutez la commande suivante :

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

Exemple pour appsettings.custom.config

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

Pour modifier la configuration de NLog, exécutez la commande suivante :

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

Exemple pour 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"
        }
      }
    }
  }
}