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.

The Linux robot runs processes developed as cross-platform in Studio that do not require UI Interaction.

Voraussetzungen

• Docker-Umgebung.
• Netzwerkverbindung zum Orchestrator.
• Machine or Machine Template Key.

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

Create an unattended robot in orchestrator, as shown in this document, then save the machine key so it can be used later.

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}
   

Logging

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

The command starts a new Robot Container with the Debug feature enabled running on port 8573. After the container is started, you can connect to the docker image using the host machine ip and the port 8573 making use of the Studio Remote Debugging feature.

If you want to debug an already started Robot container you can use the unattended robot connection feature with a robot container connected to the orchestrator.