Installation sur Linux

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

La balise d'image Docker

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

docker pull registry.uipath.com/robot/uiautomation-runtime:<tag>docker pull registry.uipath.com/robot/uiautomation-runtime:<tag>

Automatisations Linux - Particularités

Pour créer des automatisations pour Linux, assurez-vous que vous disposez de l'extension Chrome version 2021.10.4 ou ultérieure. Cela permet au robot d'exécuter des automatisations en arrière-plan et au premier plan.
Pour concevoir une UI Automation pour Linux, vous pouvez sélectionner les méthodes d’entrée suivantes pour les activités :
- ChromiumAPI : 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 (Web Recorder) : réplique une série d’actions sur une page Web qu’un robot peut relire.
- Extraction de table : un outil pour faciliter l'extraction de données à partir de tables Web.

Paramètres de la commande `docker run`

La table suivante 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>`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>`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. Si vous utilisez la clé de machine, n'utilisez pas ce paramètre.	Définit l'ID client du modèle de machine.
`CLIENT_SECRET="$Client_secret"` À utiliser avec l'ID de client.	Définit la clé secrète du client du modèle de machine.
`MACHINE_KEY="$KEY"` Si vous utilisez un ID et une clé secrète de client, n'utilisez pas ce paramètre.	Définit la clé du modèle de machine.
`VNC_ENABLED=true`	Facultatif. Permet la diffusion en direct de l'exécution du Robot sur Linux via le calcul en réseau virtuel (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>`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>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

Les automatisations sur Linux 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-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