Robots Linux

L'utilisation de Robots dans les environnements Linux vous permet d'exécuter des automatisations Unattended dans des conteneurs Docker et constitue une méthode simplifiée pour faire évoluer votre déploiement.

The Linux robot image referenced in this document can only run processes developed as cross-platform that do not require UI Interaction. To run processes that require a user interface, you need to use the Linux docker image built for Chrome Automation.

Prérequis

• Environnement Docker.
• Connexion du réseau à Orchestrator.
• Machine or Machine Template Key.

Développer des automatisations multiplateformes

Les Robots Linux ne peuvent exécuter que des automatisations Unattended. Lors de la création d'une automatisation, assurez-vous de sélectionner la compatibilité Multiplate-forme (Cross-platform). De cette façon, seules les activités multiplate-forme sont affichées, tandis que celles qui ne sont pas prises en charge sont masquées.

Les packages d'activités par défaut pour les projets multiplateformes sont :

• UiPath.System.Activities
• UiPath.UIAutomation.Activities

Déploiement

Pour déployer des robots Unattended dans un environnement Linux, suivez les étapes ci-dessous :

Configuration d'Orchestrator

Create an unattended robot in orchestrator, as shown in this document, then save the machine key so it can be used later.

Machine cliente

1. Ouvrez un terminal de ligne de commande et obtenez l'image Docker à l'aide de la commande suivante :

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

2. Démarrez l'image téléchargée à l'aide des paramètres pour connecter le Robot à Orchestrator à l'aide de la commande ci-dessous :

   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/runtimedocker 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" -ti registry.uipath.com/robot/runtime
   

   Remarque :

   Pour récupérer ou démarrer une version spécifique du Robot, remplacez le paramètre <tag> avec la version réelle de la colonne Balises des images Docker (Docker Image Tags) dans le tableau ci-dessous :

   Version du Robot	Balises d'images Docker
   2022,4	22.4.68.30958-robot22.4.6

   En l'absence de balise, le correctif Enterprise le plus récent de la dernière version Enterprise sera récupéré.

   Important :

   Si vous rencontrez des problèmes pour connecter le Robot à Orchestrator, cela peut être dû à la configuration d'une machine hôte (par exemple, des règles de pare-feu). Pour résoudre ce problème, ajoutez un serveur DNS spécifique à la commande.

   Exemple : docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/runtime

   Où 1.1.1.1 fait référence au résolveur DNS public de Cloudflare. Il peut s'agir de n'importe quel résolveur DNS capable de résoudre le hub SignalR.

   Important :

   Afin de démarrer avec succès le robot, vous devez accepter le contrat de licence en ajoutant le paramètre -e LICENSE_AGREEMENT=accept dans la commande.

   Chaque fois que vous exécutez la commande présentée à l'étape 2, un nouveau robot est généré dans Orchestrator.

3. Pour voir le statut de vos robots sur la machine, utilisez la commande suivante :

   docker ps -a
   

4. Pour déconnecter un robot, utilisez la commande ci-dessous :

   docker stop {container_id}
   

   Important :

   L'utilisation de docker kill container_id arrête le robot sur la machine mais ne le déconnecte pas d'Orchestrator.

5. Pour reconnecter un robot spécifique, utilisez la commande ci-dessous :

   docker start {container_id}
   

Logging

Si vous devez conserver les fichiers journaux au-delà du cycle de vie de l'instance de conteneur, utilisez la commande suivante :

docker run -e LICENSE_AGREEMENT=accept -e MACHINE_KEY="{machine_key}" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -v C:\Users\user.name\Desktop\logs:/root/.local/share/UiPath/Logs/ -ti registry.uipath.com/robot/runtimedocker 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" -v C:\Users\user.name\Desktop\logs:/root/.local/share/UiPath/Logs/ -ti registry.uipath.com/robot/runtime

Remarque :

L'image Robot Linux est basée sur la version Alpine Linux du mcr.microsoft.com/dotnet/runtime. Tous les fichiers requis par l'application sont placés dans le /root/application directory.

Configuration des flux de package

Les packages utilisés pour exécuter des automatisations sur les robots Linux sont disponibles dans le répertoire /root/.local/share/UiPath/Packages/ du conteneur Docker. Si vous souhaitez configurer des packages spécifiques pour la machine hôte, vous pouvez configurer le volume devant être utilisé pour conserver les packages NuGet à l'aide de la commande suivante :

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>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/runtimedocker 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" -v <path to packages>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/runtime

Où <path to packages> fait référence à l'emplacement sur la machine hôte.

Exécution de tâches sur des robots Linux

La procédure d'exécution d'une tâche Unattended sur les robots Linux est identique à celle de Windows.

Débogage à distance

Pour tester votre processus, vous pouvez activer le mode débogage à l'aide de la commande suivante :

docker run -e LICENSE_AGREEMENT=accept -e DEBUG_SESSION=true -ti -p8573:8573 registry.uipath.com/robot/runtime

The command starts a new Robot Container with the Debug feature enabled running on port 8573. After the container is started, you can connect to the docker image using the host machine ip and the port 8573 making use of the Studio Remote Debugging feature.

If you want to debug an already started Robocontainer, you can use the unattended roboot connection feature with a robot container connected to the orchestrator.