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.

L’image du robot Linux référencée dans ce document peut uniquement exécuter des processus développés en tant que processus multiplate-formes ne nécessitant pas d’interaction avec l’interface utilisateur. Afin d’exécuter des processus nécessitant une interface utilisateur, vous devez utiliser l’image docker Linux conçue pour Chrome Automation.

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

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

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

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

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.