Instalar en Linux

Instalación basada en Docker de UiPath Robot en Linux, que cubre etiquetas de imagen, particularidades de automatización de Linux y parámetros de ejecución de Docker.

La instalación de robots en Linux requiere un entorno Docker, una conexión de red a Orchestrator y las credenciales de cliente de la plantilla de máquina.

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 etiqueta de imagen de 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>

Automatizaciones de Linux: particularidades

• Para crear automatizaciones para Linux, asegúrate de tener la extensión de Chrome versión 2021.10.4 o posterior. Esto permite al robot ejecutar automatizaciones en segundo plano y en primer plano.
• Para diseñar una automatización de IU para Linux, puedes seleccionar los siguientes métodos de entrada para actividades:
  • ChromiumAPI: el modo de entrada predeterminado que permite a los robots interactuar directamente con elementos de Chrome.
  • SimularClic/SimularTipo: simula acciones del usuario, como hacer clic o escribir en una página web.
• You can also use the following tools:
  • Grabadora web: replica una serie de actions en una página web que un robot puede volver a reproducir.
  • Extracción de tablas: una herramienta para facilitar la extracción de datos de tablas web.

Parámetros para el comando docker run

La siguiente lista resume los parámetros que utiliza el docker run comando. Utiliza este comando para iniciar la imagen de Docker.

• LICENSE_AGREEMENT=accept: acepta el acuerdo de licencia de UiPath.
• ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_": establece la URL de la instancia de Orchestrator a la que deben conectarse tus robots.
• 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.
  Importante:

  Después de habilitar el servidor VNC, utiliza cualquier cliente VNC para transmitir en directo la ejecución del robot.

Los siguientes ejemplos muestran cómo ejecutar el docker run comando:

• Uso del ID de cliente y el secreto de cliente:

  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>
  

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

Error de conexión de Orchestrator

Las reglas del cortafuegos pueden bloquear la conexión a Orchestrator. Para solucionar esto, especifica un servidor DNS en el comando docker run. Por ejemplo:

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>

El valor --dns="1.1.1.1" representa el valor de resolución DNS pública de Cloudflare. Puedes utilizar cualquier servidor de resolución DNS para redirigir el hub de SignalR.

Configuring package feeds

Las automatizaciones en Linux requieren ciertas bibliotecas, que se almacenan en el directorio /home/robotuser/.nuget/Packages/ de un contenedor de Docker. Para configurarlo, debes montar el directorio que contiene las bibliotecas de NuGet. Añade el siguiente indicador al comando de ejecución de Docker: -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages/.

Por ejemplo:

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

Importante:

Asegúrate de que el usuario Linux del robot (UID1000) tenga acceso de lectura a la ruta montada que conduce a las fuentes de paquetes.

Depuración remota

Para depurar un contenedor de robot en ejecución, utiliza la característica de depuración remota.