Linux-Roboter

Mit dem Robot Linux-Image können Sie plattformübergreifende Automatisierungen in Docker-Containern ausführen.

Das Roboter-Linux-Image basiert auf der Ubuntu Linux-Version von mcr.microsoft.com/dotnet/runtime. Alle für die Anwendung erforderlichen Dateien werden im /application/-Verzeichnis platziert.

Voraussetzungen

• Docker-Umgebung.
• Netzwerkverbindung zum Orchestrator.
• Client-Anmeldeinformationen für Maschinenvorlage.

Bereitstellung

Um Roboter in einer Linux-Umgebung zu verwenden, erstellen Sie einen Unattended Robot im Orchestrator, speichern Sie die ClientID und das ClientGeheimnis für die spätere Verwendung, und führen Sie dann die folgenden Schritte auf der Robotermaschine aus:

1. Öffnen Sie ein Befehlszeilenterminal und rufen Sie das Docker-Image mit dem folgenden Befehl ab:

   docker pull registry.uipath.com/robot/uiautomation-runtime:<tag>

   Hinweis: Wenn kein spezifischer Tag verwendet wird, wird der neueste Enterprise-Patch für die neueste Enterprise-Version abgerufen. Um eine bestimmte Version des Roboters abzurufen oder zu starten, ersetzen Sie den Parameter <tag> durch die aktuelle Version aus der Spalte Docker-Image-Tags in der nachfolgenden Tabelle:

   Roboterversion	Docker-Bild-Tags
   2023.4	23.4.67.64126-robot23.4.5

2. Basierend auf dem Verbindungstyp können Sie das heruntergeladene Image starten und den Roboter über einen der folgenden Befehle mit dem Orchestrator verbinden:
   Wichtig: Um den Roboter erfolgreich zu starten, müssen Sie die Lizenzvereinbarung akzeptieren, indem Sie dem Befehl den Parameter -e LICENSE_AGREEMENT=accept hinzufügen.
   1. Client-ID und geheimer Clientschlüssel:

      docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_"-e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid registry.uipath.com/robot/uiautomation-runtime:<tag>

   2. Maschinenschlüssel:

      docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/uiautomation-runtime:<tag>

Wichtig: Wenn Sie Probleme haben, den Roboter mit dem Orchestrator zu verbinden, kann dies an der Konfiguration der Hostmaschine liegen (z. B. an Firewall-Regeln). Um dies zu beheben, fügen Sie einen bestimmten DNS-Server in den Befehl ein.

Beispiel für eine DNS-Konfiguration:

docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid registry.uipath.com/robot/uiautomation-runtime:<tag>

Wobei 1.1.1.1 sich auf den öffentlichen DNS-Resolver von Cloudflare bezieht. Dies kann ein DNS-Resolver sein, der den SignalR Hub auflösen kann.

Wichtig: Jedes Mal, wenn Sie den Befehl in Schritt 2 ausführen, wird eine neue Unattended-Sitzung im Orchestrator erstellt. Um dies zu vermeiden, verwenden Sie den Befehl docker start {container_id}, um einen bereits erstellten Container zu starten.

1. Um den Status Ihrer Roboter auf der Maschine anzuzeigen, verwenden Sie den folgenden Befehl:

   docker ps -a

2. Um einen Roboter zu trennen, verwenden Sie den folgenden Befehl:

   docker stop {container_id}

   Wichtig: Die Verwendung von docker kill container_id hält den Roboter auf der Maschine an, trennt ihn jedoch nicht vom Orchestrator.
3. Um einen bestimmten Roboter erneut zu verbinden, verwenden Sie den folgenden Befehl:

   docker start {container_id}

Erstellen von Automatisierungen für Linux-Roboter

Der Linux-Roboter kann sowohl Hintergrund- als auch Vordergrundautomatisierungen (mit Google Chrome) ausführen.

Wenn Sie eine mit Linux-Robotern kompatible Webautomatisierung erstellen möchten, führen Sie die folgenden Schritte aus:

1. Wählen Sie beim Erstellen eines neuen Prozesses den plattformübergreifenden Projekttyp in Studio aus.
2. Aktualisieren Sie in Studio über den Paket-Managerdas UI-Automatisierungsaktivitätspaket auf die neueste Version. Diese Funktion ist erst ab dem Paket v21.11.0-preview verfügbar. Da Sie ein plattformübergreifendes Projekt verwenden, werden nur die Aktivitätspakete angezeigt, die plattformübergreifende Projekte unterstützen.
3. Zum Erstellen einer Webautomatisierung benötigen Sie auch die neueste Chrome-Erweiterung. Sie können sie auf folgende Weise bequem installieren:
   • Aus Studio
   • Aus Setup-Erweiterungen
   Hinweis: Sie müssen die Chrome-Erweiterung v21.10.4 oder neuer installiert haben, bevor Sie mit dem Entwerfen der Automatisierung beginnen.

Beim Entwerfen des UI-Automatisierungsprojekts für Linux-Roboter können Sie die folgenden Eingabemethoden für Aktivitäten verwenden:

• ChromiumAPI (Standard)
• SimulateClick/SimulateType

Darüber hinaus werden die folgenden Assistenten unterstützt:

• Web- Recorder
• Tabellenextraktion

Ausführen von Automatisierungen auf Linux-Robotern

Das Ausführen eines Unattended-Auftrags auf Linux-Robotern funktioniert gleich wie unter Windows.

Wenn Sie die Live-Ausführung eines Prozesses anzeigen möchten, können Sie dies mit dem vorkonfigurierten VNC-Server tun, auf den über den Standardport 5900 zugegriffen werden kann. Um während der Prozessausführung eine Verbindung damit herzustellen, müssen Sie den VNC-Port beim Starten des Images veröffentlichen, indem Sie dem BefehlDocker Run -p {localVncPort}:5900 --env VNC_ENABLED=true-Parameter hinzufügen.

docker run -e LICENSE_AGREEMENT=accept -e
ORCHESTRATOR_URL="{orchestrator url}" -e MACHINE_KEY="{machine_key}" -p 50000:5900 --env VNC_ENABLED=true registry.uipath.com/robot/uiautomation-runtime:<tag>

Dieser Befehl macht den VNC-Server über die lokale Maschine verfügbar (50000 port). Danach können Sie einen beliebigen VNC-Client verwenden, um die Ausführung des Roboters live zu verfolgen.

Remote-Debugging

Sie können einen bereits gestarteten Roboter-Container über die Verbindungsfunktion für Unattended Robot debuggen.

Protokollierung

Protokolle zur Prozessausführung finden Sie im Ordner /home/robotuser/.local/share/UiPath/Logs auf dem Docker-Image.

Um Protokolle aus dem Container zu extrahieren, verwenden Sie den folgenden Befehl:

docker cp <ContainerId>:/home/robotuser/.local/share/UiPath/Logs <TargetPath>

Konfigurieren von Paketfeeds

Die Bibliotheken, die zum Ausführen von Automatisierungen auf den Linux-Robotern verwendet werden, können im Verzeichnis /application/Packages/ im Docker-Container abgelegt werden. Dies kann konfiguriert werden, indem Sie das Verzeichnis, das die NuGet-Bibliotheken enthält, mit dem folgenden Befehl einbinden:

docker run -e LICENSE_AGREEMENT=accept -e MACHINE_KEY="{machine_key}" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -v <path to packages on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-runtimedocker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -v <path to packages on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-runtime:<tag>

Dabei bezieht sich <path to packages> auf den Speicherort auf der Hostmaschine.

Stellen Sie sicher, dass der Roboterbenutzer (UID 1000-Benutzer) Lesezugriff auf den bereitgestellten Pfad zu den Paketfeeds hat.