Robots de Linux

La imagen de Robot Linux le 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, cree un Unattended Robot en Orchestrator, guarde ClientID y ClientSecret para usarlos más tarde y, a continuación, siga los pasos que se indican a continuación en la máquina del robot:

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

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

   Nota: Al no usar una etiqueta específica, se recupera el parche de Enterprise más reciente para la última versión de Enterprise . Para recuperar o iniciar una versión específica del robot, reemplaza el <tag> parámetro con 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.4	23.4.67.64126-robot23.4.5

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 con éxito el robot, 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: 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 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 ejecuta el comando en el paso 2, se crea una nueva sesión Unattended en Orchestrator. Para evitar esto, 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_iddetienes 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}

Creación de 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 Administrador de paquetes, actualice el paquete de actividades de automatización de la IU a la última versión. Esta función solo está disponible a partir del paquete de vista previa v21.11.0. 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: Debe tener la extensión de Chrome v21.10.4 o más reciente instalada 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 Unattended en robots de 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

Puede depurar un contenedor de robot ya iniciado a través de la función de conexión deUnattended Robot .

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.