UiPath Documentation
robot
2022.4
false
Guía de usuario del robot
Importante :
La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

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.

The Linux robot image referenced in this document can only run processes developed as cross-platform that do not require UI Interaction. To run processes that require a user interface, you need to use the Linux docker image built for Chrome Automation.

Requisitos previos​

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​

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

    :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 robotEtiquetas de imagen de Docker
    2022.422.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:

    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
docker ps -a

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

    docker stop {container_id}
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}
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/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
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 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.

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
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
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 Robocontainer, you can use the unattended roboot connection feature with a robot container connected to the orchestrator.

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado