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

The following list summarizes the parameters used by the docker run command. Use this command to start the Docker image.

• LICENSE_AGREEMENT=accept - Accepts the UiPath license agreement.
• ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" - Sets the URL of the Orchestrator instance where your robots should connect.
• CLIENT_ID="$Client_ID" and CLIENT_SECRET="$Client_secret" - Set the client ID and client secret of the machine template. If you use the machine key, do not use these parameters.
• MACHINE_KEY="$KEY" - Sets the key of the machine template. If you use client ID and secret, do not use this parameter.
• VNC_ENABLED=true - Optional. Enables the live streaming of the Robot execution on Linux through Virtual Networking Computing (VNC). Requires port 5000:5900 for accessing the VNC server.
  Important: After enabling the VNC server, use any VNC client to live stream the robot execution.

The following examples show how to run the docker run command:

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

• With 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.