Installation unter Linux

Docker-basierte Installation von UiPath Robot unter Linux, die Image-Tags, Besonderheiten bei der Linux-Automatisierung und Docker-Ausführungsparameter abdeckt.

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

The Linux Robot image runs RPA processes and test cases from cross-platform projects. Running agents, functions, and API workflows on Linux robots is planned.

The image is for x64 (amd64) hosts only.

Das Docker Image-Tag

To install the Docker image of a specific Robot version, mention the tag. To install the latest patch available, do not mention a tag. The command to download the Docker image is:

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.
• You can also use the following tools:
  • 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 docker runBefehl

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/tenant/orchestrator_" – Legt die URL der Orchestrator-Instanz fest, mit der Ihre Roboter eine Verbindung herstellen sollen.
• CLIENT_ID="$Client_ID" and CLIENT_SECRET="$Client_secret" - Set the client ID and client secret of the machine template.
• MACHINE_KEY="$KEY" - Deprecated. Connects with the key of the machine template instead of the client ID and client secret. Don't combine it with them. Use client credentials instead.
• VNC_ENABLED=true - Optional. Enables the live streaming of the Robot execution on Linux through Virtual Networking Computing (VNC). Requires publishing port 5900 to the host, for example -p 50000:5900, to access the VNC server.
  Wichtig:

  Nachdem Sie den VNC-Server aktiviert haben, können Sie mit einem beliebigen VNC-Client einen Livestream der Roboterausführung erstellen.

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/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>
  

• Mit VNC_ENABLED=true:

  docker run -e LICENSE_AGREEMENT=accept -e
  ORCHESTRATOR_URL="{orchestrator url}" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -p 50000:5900 --env VNC_ENABLED=true uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>
  

Fehler bei der Orchestrator-Verbindung

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/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/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:

docker run -e LICENSE_AGREEMENT=accept -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages -ti uipathprod.azurecr.io/robot/uiautomation-runtime

Wichtig:

Stellen Sie sicher, dass der Linux-Robot-Benutzer (UID1000) Lesezugriff auf den eingebundenen Pfad hat, der zu den Paketfeeds führt.

Remote-Debugging

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