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.

Le robot Linux exécute des processus développés en tant que processus multiplateforme dans Studio et ne nécessitant pas d'interaction avec l'interface utilisateur.

Prérequis

• Environnement Docker.
• Connexion du réseau à Orchestrator.
• Clé de machine ou de modèle de machine.

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

Créez un robot Unattended dans Orchestrator, comme expliqué dans ce document, puis enregistrez la clé de la machine afin qu'elle puisse être utilisée ultérieurement.

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é.

   Attention : 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}

   Attention : 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}

Journalisation

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

La commande démarre un nouveau conteneur Robot avec la fonctionnalité de débogage (Debug) activée et en cours d'exécution sur le port 8573. Une fois le conteneur démarré, vous pouvez vous connecter à l'image Docker à l'aide du host machine ip et du port 8573 en utilisant la fonction de débogage à distance de Studio (Studio Remote Debugging).

Si vous souhaitez déboguer un conteneur Robot déjà démarré, vous pouvez utiliser la fonctionnalité de connexion de Robot Unattended avec un conteneur robot connecté à Orchestrator.