Robots de Linux

El uso de UiPath Robots en entornos Linux te permite ejecutar automatizaciones desatendidas en contenedores de Docker, lo que ofrece una forma sencilla de escalar la implementación.

La imagen de robot de Linux a la que se hace referencia en este documento solo puede ejecutar procesos desarrollados como multiplataforma que no requieren interacción de la IU. Para ejecutar procesos que requieren interfaz de usuario, tienes que usar la imagen de docker de Linux construida para Automatización de Chrome.

Requisitos previos

• Entorno Docker.
• Conexión de red a Orchestrator.
• Clave de la máquina o de la plantilla de la máquina.

Desarrollo de automatizaciones multiplataforma

Los UiPath Robots de Linux solo pueden ejecutar automatizaciones desatendidas. Al crear una automatización, asegúrate de seleccionar la compatibilidad multiplataforma. De este modo, solo se muestran las actividades multiplataforma, mientras que las que no son compatibles se ocultan.

Los paquetes de actividades por defecto para los proyectos multiplataforma son:

• UiPath.System.Activities
• UiPath.UIAutomation.Activities

Implementación

Para desplegar robots desatendidos en un entorno Linux, sigue los siguientes pasos:

Configuración de Orchestrator

Crea un robot desatendido en Orchestrator, como se muestra en este documento, y guarda la clave de la máquina para poder utilizarla más adelante.

Máquina cliente

1. Abre un terminal de línea de comandos y obtén la imagen de Docker utilizando el siguiente comando:

   docker pull registry.uipath.com/robot/runtimedocker pull registry.uipath.com/robot/runtime:<tag>

2. Inicia la imagen descargada usando los parámetros para conectar el UiPath Robot a Orchestrator mediante el siguiente comando:

   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/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" -ti registry.uipath.com/robot/runtime

   Nota: para recuperar o iniciar una versión específica del UiPath Robot, sustituye el <tag>parámetro por la versión real de la columna Etiquetas de imagen de Docker en la siguiente tabla:

   Versión robot	Etiquetas de imagen de Docker
   2022.4	22.4.68.30958-robot22.4.6

   Si no usas ninguna etiqueta se recupera el parche empresarial más reciente para la versión empresarial más reciente.

   Importante: ei tiene problemas para conectar el robot a Orchestrator, puede deberse a una configuración del equipo host (p. ej. reglas del firewall). Para resolverlo, añade un servidor DNS específico en el comando.
   Ejemplo: docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/runtime
   En el que 1.1.1.1 se refiere a la resolución DNS pública desde Cloudflare. Puede ser cualquier resolución DNS que pueda resolver el Hub SignalR.
   Importante:

   Para poder iniciar el robot con éxito, debes aceptar el acuerdo de licencia añadiendo el parámetro -e LICENSE_AGREEMENT=accept en el comando.

   Cada vez que se ejecuta el comando presentado en el paso 2, se genera un nuevo robot en Orchestrator.

3. Para ver el estado de tus robots en la máquina, usa el siguiente comando:

   docker ps -a

4. Para desconectar un robot, usa el siguiente comando:

   docker stop {container_id}

   Importante: al usar , docker kill container_iddetienes el robot en la máquina, pero no lo desconecta de Orchestrator.

5. Para reconectar un robot específico, usa el siguiente comando:

   docker start {container_id}

Registro

Si necesitas preservar los archivos de registro más allá del ciclo de vida de la instancia del contenedor, usa el siguiente comando:

docker run -e LICENSE_AGREEMENT=accept -e MACHINE_KEY="{machine_key}" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -v C:\Users\user.name\Desktop\logs:/root/.local/share/UiPath/Logs/ -ti registry.uipath.com/robot/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 C:\Users\user.name\Desktop\logs:/root/.local/share/UiPath/Logs/ -ti registry.uipath.com/robot/runtime

Nota: la imagen Robot Linux está basada en la versión Alpine Linux del mcr.microsoft.com/dotnet/runtime. Todos los archivos necesarios para la aplicación se ubican en /root/application directory.

Configuración de fuentes de paquete

Los paquetes utilizados para ejecutar automatizaciones en los robots Linux están disponibles en el directorio /root/.local/share/UiPath/Packages/ del contenedor de Docker. Si quieres configurar paquetes específicos para la máquina host, puedes configurar el volumen que se debe usar para que persista los paquetes nuget usando el siguiente comando:

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>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/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>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/runtime

Donde <path to packages> se refiere a la ubicación en la máquina host.

Ejecución de trabajos en Robots Linux

El procedimiento para ejecutar un trabajo desatendido en robots Linux es idéntico al de Windows.

Depuración remota

Para probar tu proceso, puedes activar el modo de depuración mediante el siguiente comando:

docker run -e LICENSE_AGREEMENT=accept -e DEBUG_SESSION=true -ti -p8573:8573 registry.uipath.com/robot/runtime

El comando inicia un nuevo contenedor de UiPath Robot con la función de depuración activada que se ejecuta en el puerto 8573. Una vez iniciado el contenedor, puedes conectarte a la imagen de Docker usando host machine ipy el puerto , 8573haciendo uso de la función Depuración remota de Studio.

Si quieres depurar un contenedor de robots ya iniciado, puedes utilizar la característica de conexión de UiPath Robot desatendido con un contenedor de robots conectado a Orchestrator.