Installation sur Linux

L’installation de Robots sur Linux nécessite un environnement Docker, une connexion réseau à Orchestrator, ainsi que les informations d’identification client du modèle de machine.

La balise de l'image Docker

Pour installer l'image Docker d'une version Robot LTS spécifique, vous devrez mentionner sa balise. Pour la version 2024.10, la balise est latest24.10. Pour installer le dernier correctif disponible, ne mentionnez pas de balise. La commande pour télécharger l'image Docker est la suivante :

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

Automatisations Linux - Particularités

• Pour créer des automatisations pour Linux, veillez à bien disposer de l'extension Chrome version 2021.10.4 ou ultérieure. Cela permettra au Robot d'exécuter des automatisations en arrière-plan et en premier plan.

• Afin de concevoir une UI Automation pour Linux, vous pouvez sélectionner les méthodes d’entrée suivantes pour les activités :

  • APIChromium : le mode d'entrée par défaut qui permet aux Robots d'interagir directement avec les éléments Chrome.

  • SimulerClic/SimulerType : simule les actions de l’utilisateur telles que cliquer ou taper sur une page Web.

  Vous pouvez également utiliser les outils suivants :

  • Enregistreur Web : réplique une série d’actions sur une page Web qu’un Robot pourra effectuer à son tour.

  • Extraction de table : un outil pour faciliter l'extraction de données à partir de tables Web.

Paramètres de la commande 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:

• Utilisation de l’ID client et de la clé secrète du client :

  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>

• Utilisation de la clé de machine :

  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>

Échec de la connexion à Orchestrator

Les règles de pare-feu peuvent bloquer la connexion à Orchestrator. Pour résoudre ce problème, spécifiez un serveur DNS dans la commande docker run. Par exemple :

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>

La valeur --dns="1.1.1.1" représente le résolveur DNS public de Cloudflare. Vous pouvez utiliser n'importe quel résolveur DNS pour rediriger le hub SignalR.

Configuring package feeds

Sur Linux, les automatisations nécessitent certaines bibliothèques qui sont stockées dans le répertoire /home/robotuser/.nuget/Packages/ d'un conteneur Docker. Pour configurer cela, vous devez monter le répertoire contenant les bibliothèques NuGet. Ajoutez l'indicateur suivant à la commande d'exécution de Docker : -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages/.

Par exemple, en utilisant la clé de machine :

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

Important : assurez-vous que l'utilisateur Linux du Robot (UID1000) dispose d'un accès en lecture au chemin monté vers les flux de package.

Débogage à distance

Pour déboguer un conteneur Robot en cours d'exécution, utilisez la fonctionnalité de débogage à distance.