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 24.10.95.24248-robot24.10.0. Um den neuesten verfügbaren Patch zu installieren, geben Sie kein Tag an. Der Befehl zum Herunterladen des Docker-Images lautet:

docker pull registry.uipath.com/robot/uiautomation-runtime:<tag>docker pull registry.uipath.com/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 auswählen:
- ChromiumAPI: Der Standardeingabemodus, der Robotern die direkte Interaktion mit Chrome-Elementen ermöglicht.
- KlickSimulieren/TypSimulieren (SimulateType): Simuliert Benutzeraktionen wie Klicken oder Tippen auf einer Webseite.
Darüber hinaus können Sie die folgenden Tools verwenden:
- Web-Recorder (Web Recorder): Repliziert eine Reihe von Aktionen auf einer Webseite, die ein Roboter wiedergeben kann.
- Tabellenextraktion: Ein Tool zur Vereinfachung der Datenextraktion aus Webtabellen.

Parameter für den Befehl `docker run`

Die folgende Tabelle fasst die Parameter zusammen, die vom Befehl docker run verwendet werden. Verwenden Sie diesen Befehl, um das Docker-Image zu starten.

Parameter	Beschreibung	Beispiel
`LICENSE_AGREEMENT=accept`	Akzeptiert die UiPath-Lizenzvereinbarung.	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>`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>`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>
`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"` Zusammen mit dem geheimen Clientschlüssel verwenden. Wenn Sie den Maschinenschlüssel verwenden, verwenden Sie diesen Parameter nicht.	Legt die Client-ID der Maschinenvorlage fest.
`CLIENT_SECRET="$Client_secret"` Zur Verwendung zusammen mit der Client-ID.	Legt den geheimen Clientschlüssel der Maschinenvorlage fest.
`MACHINE_KEY="$KEY"` Wenn Sie die Client-ID und den geheimen Schlüssel verwenden, verwenden Sie diesen Parameter nicht.	Legt den Schlüssel der Maschinenvorlage fest.
`VNC_ENABLED=true`	Optional. Ermöglicht das Livestreaming der Roboterausführung unter Linux durch Virtual Networking Computing (VNC). Erfordert Port `5000:5900` für den Zugriff auf den VNC-Server. Wichtig: Verwenden Sie nach dem Aktivieren des VNC-Servers einen beliebigen VNC-Client, um die Roboterausführung live zu streamen.	`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>`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>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-runtimedocker 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