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

Le tableau suivant résume les paramètres utilisés par la commande docker run. Utilisez cette commande pour démarrer l'image Docker.

Paramètre	Description	Exemple
LICENSE_AGREEMENT=accept	Accepte le contrat de licence UiPath.	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>
ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_"	Définit l'URL de l'instance Orchestrator à laquelle vos Robots doivent se connecter.
CLIENT_ID="$Client_ID" À utiliser avec la clé secrète du client. N'utilisez pas ce paramètre si vous utilisez la clé de machine.	Définit l'ID client du modèle de machine.
CLIENT_SECRET="$Client_secret" À utiliser avec l’ID client.	Définit la clé secrète pour le client du modèle de machine.
MACHINE_KEY="$KEY" N'utilisez pas ce paramètre si vous utilisez un ID et une clé secrète de client.	Définit la clé du modèle de machine.
VNC_ENABLED=true	Facultatif. Permet de diffuser en direct l'exécution du Robot sur Linux via Virtual Network Computing (VNC). Nécessite le port 5000:5900 pour accéder au serveur VNC. Important : Après avoir activé le serveur VNC, utilisez n'importe quel client VNC pour diffuser en direct l'exécution du Robot.	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.