Robôs do Linux

Usar Robots em ambientes do Linux permite que você execute automações Unattended em contêineres do Docker, proporcionando uma forma fácil de ampliar sua implantação.

A imagem do Linux Robot mencionada neste documento só pode executar processos desenvolvidos como multiplataforma que não exijam interação com a Interface Gráfica. Para executar processos que exigem uma interface do usuário, você precisa usar a imagem do Linux Docker criada para automação no Chrome.

Pré-requisitos

• Ambiente Docker
• Conexão de rede com o Orchestrator.
• Chave da máquina ou do modelo de máquina.

Desenvolvimento de automações multiplataforma

Os robôs Linux só podem executar automações não assistidas. Ao criar uma automação, certifique-se de selecionar a compatibilidade multiplataforma. Dessa maneira, apenas atividades multiplataforma são exibidas, enquanto as não suportadas ficam ocultas.

Os pacotes de atividades padrão para projetos multiplataforma são:

• UiPath.System.Activities
• UiPath.UIAutomation.Activities

Implantação

Para implantar robôs não assistidos em um ambiente Linux, siga as etapas abaixo:

Configuração do Orchestrator

Crie um robô não assistido no Orchestrator, conforme mostrado neste documento, e salve a chave da máquina para que possa ser usada posteriormente.

Máquina do cliente

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

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

2. Inicie a imagem baixada usando os parâmetros para conectar o Robô ao Orchestrator, usando o comando abaixo:

   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/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" -ti registry.uipath.com/robot/runtime

   Observação: para recuperar ou iniciar uma versão específica do Robot, substitua o parâmetro <tag> pela versão real da coluna Tags da imagem do docker, na tabela abaixo:

   no mínimo 2021.8	Tags de imagem do docker
   2022.4	22.4.68.30958-robot22.4.6

   Não usar qualquer tag recupera o patch do Enterprise mais recente para a versão do Enterprise mais recente.

   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: docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/runtime
   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.
   Importante:

   Para iniciar o robô com sucesso, você deve aceitar o contrato de licença adicionando o parâmetro -e LICENSE_AGREEMENT=accept no comando.

   Sempre que você executar o comando apresentado na etapa 2, um novo robô é gerado no Orchestrator.

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

   docker ps -a

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

5. Para reconectar um robô específico, use o comando abaixo:

   docker start {container_id}

Geração de logs

Se você precisar que os arquivos de log persistam além do ciclo de vida da instância do contêiner, use 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 C:\Users\user.name\Desktop\logs:/root/.local/share/UiPath/Logs/ -ti registry.uipath.com/robot/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 C:\Users\user.name\Desktop\logs:/root/.local/share/UiPath/Logs/ -ti registry.uipath.com/robot/runtime

Observação: A imagem do robô Linux é baseada na versão Alpine Linux do mcr.microsoft.com/dotnet/runtime. Todos os arquivos necessários pelo aplicativo são colocados no /root/application directory.

Configuração de feeds de pacotes

Os pacotes usados para executar automações nos Robots do Linux estão disponíveis no diretório /root/.local/share/UiPath/Packages/ no contêiner do Docker. Se você desejar configurar pacotes específicos para a máquina do host, você pode configurar o volume que deve ser usado para persistir os pacotes 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>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/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>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/runtime

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

Executar trabalhos em Robôs do Linux

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

Depuração remota

Para testar seu processo, você pode habilitar o modo de depuração usando o seguinte comando:

docker run -e LICENSE_AGREEMENT=accept -e DEBUG_SESSION=true -ti -p8573:8573 registry.uipath.com/robot/runtime

O comando inicia um novo Contêiner de Robô com o recurso Depurar habilitado, executando na porta 8573. Após o contêiner ser iniciado, você pode se conectar à imagem do docker usando o host machine ip e a porta 8573, usando o recurso de Depuração Remota do Studio.

Se quiser depurar um Robocontainer já iniciado, você pode usar o recurso de conexão de robô não assistido com um contêiner de robô conectado ao Orchestrator