Robots Linux

L'utilisation de Robots dans les environnements Linux vous permet d'exécuter des automatisations non assistées dans des conteneurs Docker et offre une expérience plus rapide et un moyen plus simple de faire évoluer votre déploiement.

The Linux robot runs processes developed as cross-platform in Studio that do not require UI Interaction.

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 non assistées qui ne nécessitent pas d'interface utilisateur. Pour ce faire, lors de la création d'une automatisation, assurez-vous de sélectionner Cross-platform.

De cette façon, seules les activités multiplateformes 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.WebApi.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 du robot et connectez 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 MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/runtime:<tag>
   

   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
   2021.10	21.10.7 21.10.6 21.10.5 21.10.3

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

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 Robot container you can use the unattended robot connection feature with a robot container connected to the orchestrator.