Instalação no Linux

Instalação baseada no Docker do UiPath Robot no Linux, abrangendo tags de imagem, particularidades da automação do Linux e parâmetros de execução do Docker.

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.
  • SimularClique/SimularDigitar: 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

A lista a seguir resume os parâmetros usados pelo comando docker run. Use esse comando para iniciar a imagem do Docker.

• LICENSE_AGREEMENT=accept - Aceita o contrato de licença da UiPath.
• ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" - Define o URL da instância do Orchestrator onde seus robôs devem se conectar.
• CLIENT_ID="$Client_ID" e CLIENT_SECRET="$Client_secret" - Configure o ID do cliente e o Segredo do cliente do modelo de máquina. Se você usar a chave da máquina, não use esses parâmetros.
• MACHINE_KEY="$KEY" - Define a chave do modelo de máquina. Se você usar a ID e o segredo do cliente, não use esse parâmetro.
• VNC_ENABLED=true - Opcional. Permite a transmissão ao vivo da execução do robô no Linux por meio do Virtual Networking Computing (VNC). Requer porta 5000:5900 para acessar o servidor VNC.
  Importante:

  Após habilitar o servidor VNC, use qualquer cliente VNC para transmitir ao vivo a execução do Robô.

Os seguintes exemplos mostram como executar o comando docker run:

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

• Com 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 na 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.