Linux-Roboter

Roboter in Linux-Umgebungen ermöglichen Ihnen das Ausführen unbeaufsichtigter Automatisierungen in Docker-Containern und bieten eine einfache Möglichkeit zur Skalierung Ihrer Bereitstellung.

Das Linux-Roboter-Image, auf das in diesem Dokument verwiesen wird, kann nur Prozesse ausführen, die plattformübergreifend entwickelt wurden und keine UI-Interaktion erfordern. Um Prozesse auszuführen, die eine Benutzeroberfläche erfordern, müssen Sie das Linux Docker-Image verwenden, das für die Chrome-Automatisierung erstellt wurde.

Voraussetzungen

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

Entwickeln von plattformübergreifenden Automatisierungen

Linux-Roboter können nur Unattended-Automatisierungen ausführen. Achten Sie beim Erstellen einer Automatisierung darauf, die plattformübergreifende Kompatibilität auszuwählen. 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.UIAutomation.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 heruntergeladene Bild mithilfe der Parameter, um den Roboter mit dem Orchestrator zu verbinden, 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 CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -ti registry.uipath.com/robot/runtime

   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
   2022.4	22.4.68.30958-robot22.4.6

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

Konfigurieren von Paketfeeds

Die Pakete, die zum Ausführen von Automatisierungen auf den Linux-Robotern verwendet werden, sind im Verzeichnis /root/.local/share/UiPath/Packages/ im Docker-Container verfügbar. Wenn Sie bestimmte Pakete für die Hostmaschine konfigurieren möchten, können Sie mit dem folgenden Befehl das Volume konfigurieren, das zum Beibehalten der NuGet-Pakete verwendet werden soll:

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>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/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>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/runtime

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

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.