Instalação no Linux

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

A tag de imagem do Docker

Para instalar a imagem do docker de uma versão LTS específica do Robô, você precisará mencionar a tag. Para a versão 2024.10, a tag é 24.10.95.24248-robot24.10.0. Para instalar o patch mais recente disponível, não mencione uma tag. O comando para baixar a imagem do docker é:

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

Automações Linux - particularidades

• Para criar automações para Linux, você precisa da extensão do Chrome para versão 2021.10.4 ou posterior. Isso permite que o Robot 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 os 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

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

Parâmetro	Description	Exemplo
LICENSE_AGREEMENT=accept	Aceita o contrato de licença da UiPath.	Usando o ID do cliente e o 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> Usando a chave de 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>
ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_"	Define o URL da instância do Orchestrator em que seus robôs devem se conectar.
CLIENT_ID="$Client_ID" Use em conjunto com o segredo do cliente. Se você usar a chave de máquina, não use este parâmetro.	Define o ID do cliente do modelo de máquina.
CLIENT_SECRET="$Client_secret" Use com o ID do cliente.	Define o segredo do cliente do modelo de máquina.
MACHINE_KEY="$KEY" Se você usar o ID e segredo do cliente, não use esse parâmetro.	Define a chave do modelo de máquina.
VNC_ENABLED=true	Opcional. Permite a transmissão ao vivo da execução do Robô no Linux por meio da Computação de Rede Virtual (VNC). Requer porta 5000:5900 para acessar o servidor VNC. Importante: Depois de habilitar o servidor VNC, use qualquer cliente VNC para transmitir ao vivo a execução do robô.	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 de 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 SignalR Hub.

Configuring package feeds

As automações no Linux exigem 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 que contém 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 Linux do robô (UID1000) tenha acesso de leitura ao caminho montado que leva aos feeds do pacote.

Depuração remota

Para depurar um contêiner de robô em execução, use o recurso Depuração Remota.