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.

The Linux Robot image runs RPA processes and test cases from cross-platform projects. Running agents, functions, and API workflows on Linux robots is planned.

The image is for x64 (amd64) hosts only.

A tag de imagens do Docker

To install the Docker image of a specific Robot version, mention the tag. To install the latest patch available, do not mention a tag. The command to download the Docker image is:

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.
• You can also use the following tools:
  • 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/tenant/orchestrator_" - Define o URL da instância do Orchestrator onde seus robôs devem se conectar.
• CLIENT_ID="$Client_ID" and CLIENT_SECRET="$Client_secret" - Set the client ID and client secret of the machine template.
• MACHINE_KEY="$KEY" - Deprecated. Connects with the key of the machine template instead of the client ID and client secret. Don't combine it with them. Use client credentials instead.
• VNC_ENABLED=true - Optional. Enables the live streaming of the Robot execution on Linux through Virtual Networking Computing (VNC). Requires publishing port 5900 to the host, for example -p 50000:5900, to access the VNC server.
  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/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>
  

• Com VNC_ENABLED=true:

  docker run -e LICENSE_AGREEMENT=accept -e
  ORCHESTRATOR_URL="{orchestrator url}" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -p 50000:5900 --env VNC_ENABLED=true uipathprod.azurecr.io/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/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/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:

docker run -e LICENSE_AGREEMENT=accept -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages -ti uipathprod.azurecr.io/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.