Instalar en Linux

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.

La etiqueta de imagen de Docker

Para instalar la imagen de Docker de una versión específica de Robot LTS, debes mencionar la etiqueta. Para la versión 2024.10, la etiqueta es latest24.10. Para instalar el último parche disponible, no menciones una etiqueta. El comando para descargar la imagen de Docker es:

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.

  Además, puedes utilizar las siguientes herramientas:

  • 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/tentant/orchestrator_": establece la URL de la instancia de Orchestrator a la que deben conectarse tus robots.
• CLIENT_ID="$Client_ID" y CLIENT_SECRET="$Client_secret": establece el ID de cliente y el secreto de cliente de la plantilla de máquina. Si utilizas la clave de la máquina, no utilices estos parámetros.
• MACHINE_KEY="$KEY": establece la clave de la plantilla de máquina. Si utilizas el ID de cliente y el secreto, no uses este parámetro.
• VNC_ENABLED=true: Opcional. Permite la transmisión en vivo de la ejecución del robot en Linux a través de Virtual Networking Computing (VNC). Requiere puerto 5000:5900 para acceder al servidor VNC.
  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/tentant/orchestrator_"-e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid registry.uipath.com/robot/uiautomation-runtime:<tag>

• Uso de la clave de la máquina:

  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>

• Con VNC_ENABLED=true:

  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>

Fallo 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/tentant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid registry.uipath.com/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, utilizando la clave de la máquina:

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>:/home/robotuser/.nuget/Packages -ti registry.uipath.com/robot/uiautomation-runtime

Importante: Asegúrate de que el usuario del robot Linux (UID1000) tiene acceso de lectura a la ruta montada que lleva a los repositorios de paquetes.

Depuración remota

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