Installation sur Linux

Installation basée sur Docker du Robot UiPath sur Linux, couvrant les balises d'image, les particularités de l'automatisation Linux et les paramètres d'exécution de Docker.

L’installation de Robots sur Linux nécessite un environnement Docker, une connexion réseau à Orchestrator, ainsi que les informations d’identification client du modèle de machine.

The Linux Robot image runs RPA processes and test cases from cross-platform projects. Running agents, functions, and API workflows on Linux robots is planned.

The image is for x64 (amd64) hosts only.

La balise de l'image Docker

To install the Docker image of a specific Robot version, mention the tag. To install the latest patch available, do not mention a tag. The command to download the Docker image is:

docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>

Automatisations Linux - Particularités

• Pour créer des automatisations pour Linux, veillez à bien disposer de l'extension Chrome version 2021.10.4 ou ultérieure. Cela permettra au Robot d'exécuter des automatisations en arrière-plan et en premier plan.
• Afin de concevoir une UI Automation pour Linux, vous pouvez sélectionner les méthodes d’entrée suivantes pour les activités :
  • APIChromium : le mode d'entrée par défaut qui permet aux Robots d'interagir directement avec les éléments Chrome.
  • SimulerClic/SimulerType : simule les actions de l’utilisateur telles que cliquer ou taper sur une page Web.
• You can also use the following tools:
  • Enregistreur Web : réplique une série d’actions sur une page Web qu’un Robot pourra effectuer à son tour.
  • Extraction de table : un outil pour faciliter l'extraction de données à partir de tables Web.

Paramètres pour la commande docker run

La liste suivante résume les paramètres utilisés par la commande docker run.Utilisez cette commande pour démarrer l'image Docker.

• LICENSE_AGREEMENT=accept - Accepte l'accord de licence UiPath.
• ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" - Définit l'URL de l'instance d'Orchestrator à laquelle vos robots doivent se connecter.
• CLIENT_ID="$Client_ID" and CLIENT_SECRET="$Client_secret" - Set the client ID and client secret of the machine template.
• MACHINE_KEY="$KEY" - Deprecated. Connects with the key of the machine template instead of the client ID and client secret. Don't combine it with them. Use client credentials instead.
• VNC_ENABLED=true - Optional. Enables the live streaming of the Robot execution on Linux through Virtual Networking Computing (VNC). Requires publishing port 5900 to the host, for example -p 50000:5900, to access the VNC server.
  Important :

  Après avoir activé le serveur VNC, utilisez n'importe quel client VNC pour diffuser en direct l'exécution du Robot.

Les exemples suivants montrent comment exécuter la commande docker run:

• Utilisation de l’ID client et de la clé secrète du client :

  docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>
  

• Avec VNC_ENABLED=true:

  docker run -e LICENSE_AGREEMENT=accept -e
  ORCHESTRATOR_URL="{orchestrator url}" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -p 50000:5900 --env VNC_ENABLED=true uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>
  

Échec de la connexion à Orchestrator

Les règles de pare-feu peuvent bloquer la connexion à Orchestrator. Pour résoudre ce problème, spécifiez un serveur DNS dans la commande docker run. Par exemple :

docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>

La valeur --dns="1.1.1.1" représente le résolveur DNS public de Cloudflare. Vous pouvez utiliser n'importe quel résolveur DNS pour rediriger le hub SignalR.

Configuring package feeds

Sur Linux, les automatisations nécessitent certaines bibliothèques qui sont stockées dans le répertoire /home/robotuser/.nuget/Packages/ d'un conteneur Docker. Pour configurer cela, vous devez monter le répertoire contenant les bibliothèques NuGet. Ajoutez l'indicateur suivant à la commande d'exécution de Docker : -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages/.

Par exemple :

docker run -e LICENSE_AGREEMENT=accept -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages -ti uipathprod.azurecr.io/robot/uiautomation-runtime

Important :

Assurez-vous que l'utilisateur du robot Linux (UID1000) dispose d'un accès en lecture au chemin d'accès monté menant aux flux de package.

Débogage à distance

Pour déboguer un conteneur Robot en cours d'exécution, utilisez la fonctionnalité de débogage à distance.