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

The following list summarizes the parameters used by the docker run command. Use this command to start the Docker image.

• LICENSE_AGREEMENT=accept - Accepts the UiPath license agreement.
• ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" - Sets the URL of the Orchestrator instance where your robots should connect.
• CLIENT_ID="$Client_ID" and CLIENT_SECRET="$Client_secret" - Set the client ID and client secret of the machine template. If you use the machine key, do not use these parameters.
• MACHINE_KEY="$KEY" - Sets the key of the machine template. If you use client ID and secret, do not use this parameter.
• VNC_ENABLED=true - Optional. Enables the live streaming of the Robot execution on Linux through Virtual Networking Computing (VNC). Requires port 5000:5900 for accessing the VNC server.
  Important: After enabling the VNC server, use any VNC client to live stream the robot execution.

The following examples show how to run the docker run command:

• 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>

• With 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.