Robots Linux

L'image Robot Linux vous permet d'exécuter des automatisations multiplate-formes dans des conteneurs Docker.

L'image Robot Linux est basée sur la version Ubuntu Linux de mcr.microsoft.com/dotnet/runtime. Tous les fichiers requis par l'application sont placés dans le répertoire /application/.

Prérequis

• Environnement Docker.
• Connexion du réseau à Orchestrator.
• Informations d'identification du client du modèle de machine.

Déploiement

Pour utiliser des robots dans un environnement Linux, créez un robot Unattended (non assisté) dans Orchestrator, enregistrez la clé de machine afin qu'elle puisse être utilisée ultérieurement, puis suivez les étapes ci-dessous sur la machine robot :

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/uiautomation-runtime:<tag>

   Remarque : En l'absence d'une balise spécifique, le correctif Enterprise le plus récent de la dernière version Enterprise sera récupéré. 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
   2023.4	23.4.67.64126-robot23.4.5

2. En fonction du type de connexion, vous pouvez ouvrir l'image téléchargée et connecter le robot à Orchestrator à l'aide de l'une des commandes ci-dessous :
   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.
   1. ID client et Clé secrète 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>

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

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 de configuration du DNS :

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>

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 : chaque fois que vous exécutez la commande à l'étape 2, une nouvelle session non assistée (unattended) est créée dans Orchestrator. Pour éviter cela, utilisez la commande docker start {container_id} pour démarrer un conteneur déjà créé.

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

   docker ps -a

2. 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.
3. Pour reconnecter un robot spécifique, utilisez la commande ci-dessous :

   docker start {container_id}

Création d'automatisations pour les robots Linux

Le robot Linux peut exécuter des automatisations en arrière-plan et au premier plan (à l'aide de Google Chrome).

Si vous souhaitez créer une automatisation web compatible avec les robots Linux, suivez les étapes ci-dessous :

1. Lors de la création d'un nouveau processus, choisissez le type de projet multiplate-forme dans Studio.
2. Dans Studio, à partir du Gestionnaire de package, mettez à jour le package d'activités UI Automation vers la dernière version. Cette fonctionnalité n'est disponible qu'à partir du package v21.11.0-preview. Étant donné que vous utilisez un projet multiplateforme, seuls les modules d'activités qui prennent en charge les projets multiplateformes s'affichent.
3. Pour créer une automatisation Web, vous avez également besoin de la dernière extension Chrome. Vous pouvez facilement l'installer des manières suivantes :
   • Depuis Studio
   • À partir des extensions de configuration
   Remarque : L'extension Chrome v21.10.4 ou une version plus récente doit être installée avant de commencer à concevoir l'automatisation.

Lors de la conception du projet UI Automation pour les robots Linux, vous pouvez utiliser les méthodes d’entrée suivantes pour les activités :

• ChromiumAPI (par défaut)
• SimulerCliquer/SimulerType

En outre, les assistants suivants sont pris en charge :

• Enregistreur Web
• Extraction de table

Exécution d'automatisations sur des robots Linux

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

Si vous souhaitez voir l'exécution en direct d'un processus, vous pouvez le faire à l'aide du serveur VNC préconfiguré, accessible via le port par défaut 5900. Pour vous y connecter pendant l'exécution du processus, vous devez publier le port VNC lors du démarrage de l'image, en ajoutant les paramètres -p {localVncPort}:5900 --env VNC_ENABLED=true à la commande Docker Run.

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>

Cette commande rend le serveur VNC disponible via la machine locale (50000 port. Après cela, vous pouvez utiliser n'importe quel client VNC pour suivre l'exécution du robot en direct.

Débogage à distance

Vous pouvez déboguer un conteneur Robot déjà démarré via la fonctionnalité de connexion Unattended Robot.

Journalisation

Les journaux associés à l'exécution du processus se trouvent dans le dossier /home/robotuser/.local/share/UiPath/Logs sur l'image Docker.

Pour extraire les journaux du conteneur, utilisez la commande suivante :

docker cp <ContainerId>:/home/robotuser/.local/share/UiPath/Logs <TargetPath>

Configuration des flux de package

Les bibliothèques utilisées pour exécuter des automatisations sur les robots Linux peuvent être placées dans le répertoire /application/Packages/ du conteneur Docker. Elles peuvent être configurées en montant le répertoire qui contient les bibliothèques 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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-runtime:<tag>

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

Assurez-vous que l'utilisateur du Robot (utilisateur UID 1000) dispose d'un accès en lecture au chemin monté vers les flux de package.