Robôs do Linux

A imagem do Linux Robot permite que você execute automações multiplataforma em contêineres Docker.

A imagem do Linux do Robô é baseada na versão Ubuntu Linux do mcr.microsoft.com/dotnet/runtime. Todos os arquivos necessários pelo aplicativo são colocados no diretório /application/ .

Pré-requisitos

• Ambiente Docker
• Conexão de rede com o Orchestrator.
• Credenciais do cliente do modelo de máquina.

Implantação

Para usar robôs em um ambiente Linux, crie um Unattended Robot no Orchestrator, salve o ClientID e o SegredoDoCliente para serem usados mais tarde e, então, siga as etapas abaixo na máquina do robô:

1. Abra um terminal de linha de comando e obtenha a imagem do docker usando o seguinte comando:

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

   Observação: não usar uma tag específica recupera o patch do Enterprise mais recente para a versão do Enterprise mais recente. Para recuperar ou iniciar uma versão específica do Robot, substitua o parâmetro <tag> pela versão real da coluna de Tags de imagem do docker , na tabela abaixo:

   no mínimo 2021.8	Tags de imagem do docker
   2023.10	23.10.69.35238-robot23.10.0

2. Com base no tipo de conexão, você pode iniciar a imagem baixada e conectar o robô ao Orchestrator usando um dos comandos abaixo:
   Importante: para iniciar o UiPath Robot com sucesso, você deve aceitar o contrato de licença adicionando o parâmetro -e LICENSE_AGREEMENT=accept ao comando.
   1. ID do Cliente e 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>

   2. 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>

Importante: se você encontrar problemas ao conectar o robô ao Orchestrator, isso pode ser causado por uma configuração da máquina host (por exemplo,Regras de firewall). Para resolver isso, adicione um servidor de DNS específico no comando.

Exemplo de configuração de DNS:

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>

Onde 1.1.1.1 se refere ao resolvedor de DNS público do Cloudflare. Isso pode ser qualquer resolvedor de DNS capaz de resolver o SignalR Hub.

Observação: toda vez que você executar o comando na etapa 2, uma nova sessão não Unattended será criada no Orchestrator. Para evitar isso, use o comando docker start {container_id} para iniciar um contêiner já criado.

1. Para ver o status dos seus robôs na máquina, use o seguinte comando:

   docker ps -a

2. Para desconectar um robô, use o comando abaixo:

   docker stop {container_id}

   Importante: usar docker kill container_id para o robô na máquina, mas não o desconecta do Orchestrator.
3. Para reconectar um robô específico, use o comando abaixo:

   docker start {container_id}

Criação de automações para robôs do Linux

O robô do Linux pode executar tanto automações em segundo plano quanto em primeiro plano (usando o Google Chrome).

Se você quiser criar uma automação da Web compatível com robôs do Linux, siga as etapas abaixo:

1. Ao criar um processo, escolha o tipo de projeto multiplataforma no Studio.
2. No Studio, no Package Manager, atualize o pacote de atividades UI Automation para a versão mais recente. Esse recurso só está disponível a partir do pacote v21.11.0-preview. Como você está usando um projeto de plataforma cruzada, apenas os pacotes de atividades que oferecem suporte a projetos de plataforma cruzada são exibidos.
3. Para criar uma automação da Web, você também precisa da extensão mais recente do Chrome. Você pode instalá-lo facilmente das seguintes maneiras:
   • Do Studio
   • Das extensões de instalação
   Observação: você deve ter a extensão v21.10.4 ou mais recente do Chrome instalada antes de começar a desenvolver a automação.

Ao desenvolver o projeto de Automação de Interface Gráfica para robôs do Linux, é possível usar os seguintes métodos de entrada para as atividades:

• ChromiumAPI (padrão)
• SimularClique/SimularTipo

Além disso, os seguintes assistentes são suportados:

• Gravador da Web
• Extração da Tabela

Executando automações em Robôs do Linux

O procedimento para executar um trabalho não Unattended em robôs do Linux é idêntico ao usado no Windows.

Se você quiser visualizar a execução ao vivo de um processo, você poderá fazê-lo usando o servidor VNC pré-configurado, acessível através da porta padrão 5900 . Para se conectar a ela durante a execução do processo, é necessário publicar a porta VNC ao iniciar a imagem, adicionando parâmetros -p {localVncPort}:5900 --env VNC_ENABLED=true ao comando Docker Run .

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>

Esse comando disponibiliza o servidor VNC por meio da máquina local (50000 port. Depois disso, você poderá usar qualquer cliente VNC para acompanhar a execução do robô ao vivo.

Depuração remota

Você pode depurar um contêiner de robô já iniciado através do recurso de conexão deUnattended Robot .

Geração de logs

Os logs relacionados à execução de processos são encontrados na pasta /home/robotuser/.local/share/UiPath/Logs na imagem do Docker.

Para extrair Logs do contêiner, use o seguinte comando:

docker cp <ContainerId>:/home/robotuser/.local/share/UiPath/Logs <TargetPath>

Configuração de feeds de pacotes

As bibliotecas usadas para executar automações nos Robots do Linux podem ser colocadas no diretório /application/Packages/ no contêiner do Docker. Isso pode ser configurado montando o diretório que contém as bibliotecas do NuGet usando o seguinte 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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-runtime:<tag>

Onde <path to packages> se refere ao local na máquina do host.

Certifique-se de que o usuário do robô (usuário UID 1000) tenha acesso de leitura para o caminho montado para os feeds de pacote.