Robots de Linux

El uso de Robots en entornos Linux te permite ejecutar automatizaciones desatendidas en contenedores de Docker y proporciona una experiencia más rápida y una forma más fácil de escalar tu implementación.

The Linux robot runs processes developed as cross-platform in Studio that do not require UI Interaction.

Requisitos previos

• Entorno Docker.
• Conexión de red a Orchestrator.
• Machine or Machine Template Key.

Desarrollo de automatizaciones multiplataforma

Los robots de Linux solo pueden ejecutar automatizaciones desatendidas que no requieren interfaz de usuario. Para ello, al crear una automatización, asegúrate de seleccionar Cross-platform.

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.WebApi.Activities

Implementación

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

Configuración de Orchestrator

Create an unattended robot in orchestrator, as shown in this document, then save the machine key so it can be used later.

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 del robot y conecta UiPath Robot con Orchestrator usando 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 MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/runtime:<tag>
   

   Nota:

   :information-source: 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
   2021.10	21.10.7 21.10.6 21.10.5 21.10.3

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

   Importante:

   Si hay problemas al conectar el UiPath Robot a Orchestrator, puede deberse a una configuración de una máquina 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_id, detienes 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}
   

Logging

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/runtime

Nota:

La imagen de Robot Linux se basa en la versión de Alpine Linux de mcr.microsoft.com/dotnet/runtime. Todos los archivos necesarios para la aplicación se ubican en /root/application directory.

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

The command starts a new Robot Container with the Debug feature enabled running on port 8573. After the container is started, you can connect to the docker image using the host machine ip and the port 8573 making use of the Studio Remote Debugging feature.

If you want to debug an already started Robot container you can use the unattended robot connection feature with a robot container connected to the orchestrator.