Verwenden des Orchestrator-Konfiguratortools

Das Orchestrator-Konfiguratortool ist ein Bash-Skript, mit dem Sie Dateien und Einstellungen in der Orchestrator-Bereitstellung in der Automation Suite platzieren können. Das Tool hilft Ihnen, Speicherdateien, Anmeldeinformationsspeicher-Plugins, NLog-Erweiterungen, neue NLog-Konfigurationen hinzuzufügen und appSettings zu übersteuern.

Die Umgebung, in der Sie das Orchestrator-Konfiguratortool verwenden, muss ein Bash-Skript ausführen können und über die folgenden Tools verfügen:

• kubectl mit einer Verbindung zum Cluster konfiguriert
• jq 1.6

• rclone

  Hinweis: Führen Sie diese Schritte aus, um rclone zu installieren.

Wichtig:

Sie sollten das ArgoCD-CLI-Tool nicht unabhängig herunterladen und verwenden. Um die Kompatibilität und einen reibungslosen Betrieb sicherzustellen, empfehlen wir die Verwendung des ArgoCD-Tools, das in den Automation Suite-Artefakten enthalten ist. Dazu müssen Sie ArgoCD mit dem neuesten Installationsprogramm zu Ihrem Pfad hinzufügen, indem Sie den folgenden Befehl ausführen:

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

Um das Orchestrator-Konfigurationstool an einem beliebigen Speicherort ausführen zu können, führen Sie die folgenden Schritte aus:

1. Aktualisieren Sie die Variable PATH , sodass sie <installer-dir>/Tools enthält. Zum Beispiel:

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

2. Stellen Sie sicher, dass die jq --version -Dienstprogrammversion 1.6 ist. Ist dies nicht der Fall, aktualisieren Sie es über eine der folgenden Optionen:
   • 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

Beispiel:

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.

Führen Sie den folgenden Befehl aus, um neue Anwendungseinstellungen anzuwenden:

./orchestrator_configurator.sh -c appsettings.json

Wenn die appsettings.json -Datei noch nicht vorhanden ist, können Sie sie selbst erstellen, wie im folgenden Beispiel gezeigt:

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

Führen Sie den folgenden Befehl aus, um die NLog-Konfiguration zu ändern:

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

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