Linux-Roboter

Roboter in Linux-Umgebungen ermöglichen Ihnen das Ausführen unbeaufsichtigter Automatisierungen in Docker-Containern, beschleunigen den Vorgang und bieten Ihnen eine einfachere Möglichkeit, die Bereitstellung zu skalieren.

Der Linux-Roboter führt Prozesse aus, die plattformübergreifend in Studio entwickelt wurden und keine UI-Interaktion erfordern.

Voraussetzungen

• Docker-Umgebung.
• Netzwerkverbindung zum Orchestrator.
• Maschinen- oder Maschinenvorlagenschlüssel.

Entwickeln von plattformübergreifenden Automatisierungen

Linux-Roboter können nur Unattended-Automatisierungen ausführen, die keine Benutzeroberfläche erfordern. Wählen Sie dazu beim Erstellen einer Automatisierung Cross-platform aus.

Auf diese Weise werden nur plattformübergreifende Aktivitäten angezeigt, während nicht unterstützte Aktivitäten ausgeblendet werden.

Die standardmäßigen Aktivitätspakete für plattformübergreifende Projekte sind:

• UiPath.System.Activities
• UiPath.WebApi.Activities

Bereitstellung

Um Unattended-Roboter in einer Linux-Umgebung bereitzustellen, führen Sie die folgenden Schritte aus:

Orchestrator-Konfiguration

Erstellen Sie einen Unattended-Roboter im Orchestrator, wie in diesem Dokument gezeigt, und speichern Sie dann den Maschinenschlüssel, damit er später verwendet werden kann.

Clientmaschine

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

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

2. Starten Sie das Roboter-Image und verbinden Sie den Roboter mit dem Orchestrator, indem Sie den folgenden Befehl verwenden:

   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/runtimedocker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/runtime:<tag>

   Hinweis: 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
   2021.10	21.10.7 21.10.6 21.10.5 21.10.3

   Wenn kein Tag verwendet wird, wird der neueste Enterprise-Patch für die neueste Enterprise-Version abgerufen.

   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: docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/runtime.
   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:

   • Um den Roboter erfolgreich zu starten, müssen Sie die Lizenzvereinbarung akzeptieren, indem Sie dem Befehl den Parameter -e LICENSE_AGREEMENT=accept hinzufügen.
   • Jedes Mal, wenn Sie den in Schritt 2 vorgestellten Befehl ausführen, wird ein neuer Roboter im Orchestrator erzeugt.

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

   docker ps -a

4. 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.

5. Um einen bestimmten Roboter erneut zu verbinden, verwenden Sie den folgenden Befehl:

   docker start {container_id}

Protokollierung

Wenn Sie Protokolldateien über den Lebenszyklus der Containerinstanz hinaus beibehalten möchten, verwenden Sie den folgenden Befehl:

docker run -e LICENSE_AGREEMENT=accept -e MACHINE_KEY="{machine_key}" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -v C:\Users\user.name\Desktop\logs:/root/.local/share/UiPath/Logs/ -ti registry.uipath.com/robot/runtime

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

Ausführen von Aufträgen auf Linux-Robotern

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

Remote-Debugging

Um Ihren Prozess zu testen, können Sie den Debug-Modus mit dem folgenden Befehl aktivieren:

docker run -e LICENSE_AGREEMENT=accept -e DEBUG_SESSION=true -ti -p8573:8573 registry.uipath.com/robot/runtime

Der Befehl startet einen neuen Roboter-Container, bei dem die Debug-Funktion aktiviert ist und der auf Port 8573 ausgeführt wird. Nachdem der Container gestartet wurde, können Sie eine Verbindung mit dem Docker-Image herstellen, indem Sie die host machine ip und den Port 8573 verwenden und dabei die Studio Remote Debugging-Funktion nutzen.

Wenn Sie einen bereits gestarteten Roboter-Container debuggen möchten, können Sie die Funktion der Unattended-Roboter-Verbindung mit einem mit dem Orchestrator verbundenen Roboter-Container verwenden.