Robots de Linux

La imagen de UiPath Robot Linux te permite ejecutar automatizaciones multiplataforma en contenedores de Docker.

La imagen de Robot Linux se basa en la versión de Ubuntu Linux de mcr.microsoft.com/dotnet/runtime. Todos los archivos requeridos por la aplicación se colocan en el directorio /application/ .

Requisitos previos

• Entorno Docker.
• Conexión de red a Orchestrator.
• Credenciales de cliente de plantilla de máquina.

Implementación

Para utilizar robots en un entorno Linux, crea un robot unattended en orchestrator, guarda ClientID y ClientSecret para su uso posterior y sigue los siguientes pasos en la máquina del robot:

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/uiautomation-runtime:<tag>
   

   Nota:

   Si no se utiliza una etiqueta específica, se recupera el parche empresarial más reciente para la versión empresarial más reciente. Para recuperar o iniciar una versión específica del robot, sustituye el parámetro <tag> 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
   2023.10	23.10.69.35238-robot23.10.0

2. Según el tipo de conexión, puede iniciar la imagen descargada y conectar el robot a Orchestrator utilizando uno de los siguientes comandos:

   Importante:

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

   1. ID de cliente y 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>
      

   2. 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>
      

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 de configuración de DNS:

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>

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:

Cada vez que ejecutas el comando en el paso 2, se crea una nueva sesión unattended en Orchestrator. Para evitarlo, utiliza el comando docker start {container_id} para iniciar un contenedor ya creado.

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

   docker ps -a
   

2. 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.

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

   docker start {container_id}
   

Crear automatizaciones para robots Linux

El robot de Linux puede ejecutar automatizaciones de segundo plano y de primer plano (mediante Google Chrome).

Si desea crear una automatización web compatible con robots Linux, siga los pasos a continuación:

1. Al crear un nuevo proceso, elige el tipo de proyecto multiplataforma en Studio.
2. En Studio, desde el Gestor de paquetes, actualiza el paquete de actividades Automatización de IU a la versión más reciente. Esta característica solo está disponible a partir del paquete v21.11.0-preview. Como estás utilizando un proyecto multiplataforma, solo se muestran los paquetes de actividades que admiten proyectos multiplataforma.
3. Para crear una automatización web, también necesita la última extensión de Chrome. Puede instalarlo fácilmente de las siguientes maneras:
   • Desde Studio
   • Desde Setup Extensions
   Nota:

   Debes tener instalada la extensión de Chrome v21.10.4 o posterior antes de comenzar a diseñar la automatización.

Al diseñar el proyecto de automatización de IU para robots de Linux, puedes utilizar los siguientes métodos de entrada para las actividades:

• API de Chromium (predeterminado)
• SimularClic / SimularTipo

Además, se admiten los siguientes asistentes:

• Grabadora web
• Extracción de tablas

Ejecutar automatizaciones en Robots Linux

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

Si quieres ver la ejecución en vivo de un proceso, puedes hacerlo utilizando el servidor VNC preconfigurado, accesible a través del puerto predeterminado 5900 . Para conectarte a él durante la ejecución del proceso, debes publicar el puerto VNC al iniciar la imagen, agregando -p {localVncPort}:5900 --env VNC_ENABLED=true parámetros al Docker Run comando .

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>

Este comando hace que el servidor VNC esté disponible a través de la máquina local (50000 port. Después de esto, podrá usar cualquier cliente VNC para seguir la ejecución del robot en vivo.

Depuración remota

Puedes depurar un contenedor de robot ya iniciado a través de la característica de conexión de robot unattended.

Registro

Los registros relacionados con la ejecución del proceso se encuentran en la carpeta /home/robotuser/.local/share/UiPath/Logs en la imagen de Docker.

Para extraer registros del contenedor, use el siguiente comando:

docker cp <ContainerId>:/home/robotuser/.local/share/UiPath/Logs <TargetPath>

Configuración de fuentes de paquete

Las bibliotecas utilizadas para ejecutar automatizaciones en los robots Linux se pueden colocar en el directorio /application/Packages/ del contenedor de Docker. Esto se puede configurar montando el directorio que contiene las bibliotecas 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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-runtime:<tag>

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

Asegúrese de que el usuario del robot (usuario de UID 1000) tenga acceso de lectura a la ruta montada a las fuentes de paquetes.