robot
latest
false
UiPath logo, featuring letters U and I in white

Robot-Administratorhandbuch

Letzte Aktualisierung 19. Feb. 2025

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: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 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: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: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 den Port 5000:5900 für den Zugriff auf den VNC-Server.
Wichtig:

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

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

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
Uipath Logo White