Instalação no Linux

A instalação de Robôs no Linux requer um ambiente do Docker, uma conexão de rede com o Orchestrator e as credenciais de cliente do modelo da máquina.

A tag de imagens do Docker

Para instalar a imagem do Docker de uma versão específica do Robô LTS, você precisaria mencionar a tag. Para a versão 2024.10, a tag é latest24.10. Para instalar o patch mais recente disponível, não mencione uma tag.O comando para baixar a imagem do Docker é:

docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>

Automações do Linux - particularidades

• Para criar automações para Linux, certifique-se de ter a extensão do Chrome versão 2021.10.4 ou posterior. Isso permite que o Robô execute automações em segundo plano e primeiro plano.

• Para projetar uma automação de Interface Gráfica para Linux, você pode selecionar os seguintes métodos de entrada para atividades:

  • ChromiumAPI: o modo de entrada padrão que permite que os Robôs interajam diretamente com elementos do Chrome.

  • SimulateClick/SimulateType: simula ações do usuário, como clicar ou digitar em uma página da web.

  Além disso, você pode usar as seguintes ferramentas:

  • Gravador da web: replica uma série de ações em uma página da web que um Robô pode reproduzir.

  • Extração de tabelas: uma ferramenta para facilitar a extração de dados de tabelas da web.

Parâmetros para o comando docker run

The following list summarizes the parameters used by the docker run command. Use this command to start the Docker image.

• LICENSE_AGREEMENT=accept - Accepts the UiPath license agreement.
• ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" - Sets the URL of the Orchestrator instance where your robots should connect.
• CLIENT_ID="$Client_ID" and CLIENT_SECRET="$Client_secret" - Set the client ID and client secret of the machine template. If you use the machine key, do not use these parameters.
• MACHINE_KEY="$KEY" - Sets the key of the machine template. If you use client ID and secret, do not use this parameter.
• VNC_ENABLED=true - Optional. Enables the live streaming of the Robot execution on Linux through Virtual Networking Computing (VNC). Requires port 5000:5900 for accessing the VNC server.
  Important: After enabling the VNC server, use any VNC client to live stream the robot execution.

The following examples show how to run the docker run command:

• Uso da ID do cliente e do segredo do 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>

• Uso da chave da 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>

• With VNC_ENABLED=true:

  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>

Falha de conexão do Orchestrator

As regras do firewall podem bloquear a conexão com o Orchestrator.Para resolver isso, especifique um servidor DNS no comando docker run.Por exemplo:

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>

O valor --dns="1.1.1.1" representa o resolvedor de DNS público do Cloudflare. Você pode usar qualquer resolvedor de DNS para redirecionar o Hub do SignalR.

Configuring package feeds

Automações no Linux requerem certas bibliotecas, que são armazenadas no diretório /home/robotuser/.nuget/Packages/ de um contêiner do Docker. Para configurar isso, você precisa montar o diretório contendo as bibliotecas NuGet. Adicione o seguinte sinalizador ao comando docker run: -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages/.

Por exemplo, usando a chave da máquina:

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>:/home/robotuser/.nuget/Packages -ti registry.uipath.com/robot/uiautomation-runtime

Importante: certifique-se de que o usuário do Robô Linux (UID1000) tenha acesso de leitura ao caminho montado que leva aos feeds de pacotes.

Depuração remota

Para depurar um contêiner de Robô em execução, use a funcionalidade Depuração remota.