Installation unter Linux

Die Installation von Robotern unter Linux erfordert eine Docker-Umgebung, eine Netzwerkverbindung zum Orchestrator und die Client-Anmeldeinformationen der Maschinenvorlage.

Das Docker Image-Tag

Um das Docker-Image einer bestimmten Robot LTS-Version zu installieren, müssten Sie das Tag erwähnen. Für Version 2024.10 ist das Tag latest24.10. Um den neuesten verfügbaren Patch zu installieren, geben Sie kein Tag an. Der Befehl zum Herunterladen des Docker-Images lautet:

docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>

Linux-Automatisierungen – Besonderheiten

• Um Automatisierungen für Linux zu erstellen, stellen Sie sicher, dass Sie über die Chrome-Erweiterungsversion 2021.10.4 oder höher verfügen. Dies ermöglicht dem Roboter die Ausführung von Hintergrund- und Vordergrundautomatisierungen.

• Um eine UI-Automatisierung für Linux zu entwerfen, können Sie die folgenden Eingabemethoden für Aktivitäten wählen:

  • ChromiumAPI: Der Standardeingabemodus, der Robotern die direkte Interaktion mit Chrome-Elementen ermöglicht.

  • SimulateClick/SimulateType: Simuliert Benutzeraktionen wie Klicken oder Tippen auf einer Webseite.

  Darüber hinaus können Sie die folgenden Tools verwenden:

  • Web Recorder: Repliziert eine Reihe von Aktionen auf einer Webseite, die ein Roboter wiederholen kann.

  • Tabellenextraktion: Ein Tool zur Vereinfachung der Datenextraktion aus Webtabellen.

Parameter für den Befehl docker run

Die folgende Liste fasst die vom Befehl verwendeten Parameter zusammendocker run. Verwenden Sie diesen Befehl, um das Docker-Image zu starten.

• LICENSE_AGREEMENT=accept – Akzeptiert die UiPath-Lizenzvereinbarung.
• ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" – Legt die URL der Orchestrator-Instanz fest, mit der Ihre Roboter eine Verbindung herstellen sollen.
• CLIENT_ID="$Client_ID"und CLIENT_SECRET="$Client_secret"– Legen Sie die Client-ID und das Client-Secret der Maschinenvorlage fest.Wenn Sie den Maschinenschlüssel verwenden, verwenden Sie diese Parameter nicht.
• MACHINE_KEY="$KEY" – Legt den Schlüssel der Maschinenvorlage fest. Wenn Sie eine Client-ID und ein Schlüssel verwenden, verwenden Sie diesen Parameter nicht.
• VNC_ENABLED=true – Optional. Aktiviert das Live-Streaming der Roboter-Ausführung unter Linux über Virtual Networking Computing (VNC).Erfordert einen Port 5000:5900für den Zugriff auf den VNC-Server.
  Wichtig: Verwenden Sie nach der Aktivierung des VNC-Servers einen beliebigen VNC-Client, um die Roboter-Ausführung zu live-streamen.

Die folgenden Beispiele zeigen, wie der docker run Befehl ausgeführt wird:

• Verwenden der Client-ID und des geheimen Clientschlüssels:

  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>

• Verwenden des Maschinenschlüssels:

  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>

• Mit VNC_ENABLED=true:

  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>

Orchestrator-Verbindungsfehler

Firewall-Regeln können die Verbindung zum Orchestrator blockieren. Um dies zu beheben, geben Sie einen DNS-Server im Befehl docker run an. Zum Beispiel:

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>

Der Wert --dns="1.1.1.1" stellt den öffentlichen DNS-Resolver von Cloudflare dar. Sie können einen beliebigen DNS-Resolver verwenden, um den SignalR Hub umzuleiten.

Configuring package feeds

Automatisierungen unter Linux erfordern bestimmte Bibliotheken, die im /home/robotuser/.nuget/Packages/-Verzeichnis eines Docker-Containers gespeichert werden. Um dies zu konfigurieren, müssen Sie das Verzeichnis bereitstellen, das die NuGet-Bibliotheken enthält. Fügen Sie dem Docker-Ausführungsbefehl das folgende Flag hinzu: -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages/.

Zum Beispiel mit dem Maschinenschlüssel:

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>:/home/robotuser/.nuget/Packages -ti registry.uipath.com/robot/uiautomation-runtime

Wichtig: Stellen Sie sicher, dass der Benutzer des Linux-Roboters (UID1000) Lesezugriff auf den bereitgestellten Pfad hat, der zu den Paket-Feeds führt.

Remote-Debugging

Um einen ausgeführten Roboter-Container zu debuggen, verwenden Sie die Remote Debugging-Funktion.