Robôs do Linux

Usar Robôs em ambientes Linux permite que você execute automações não assistidas em contêineres Docker, fornecendo uma experiência mais rápida e uma maneira mais fácil de escalar sua implantação.

O Linux Robot executa processos desenvolvidos como multiplataforma no Studio que não exigem interação com a Interface do Usuário.

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 do Linux só podem executar automações não assistidas que não exigem interface de usuário. Para isso, ao criar uma automação, certifique-se de selecionar Cross-platform.

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.WebApi.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 do Robot e conecte o Robot 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 MACHINE_KEY="$KEY" -tid registry.uipath.com/robot/runtime:<tag>

   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
   2021.10	21.10.7 21.10.6 21.10.5 21.10.3

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

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 você quiser depurar um contêiner de Robô já iniciado, você pode usar o recurso de conexão de robô não assistido com o contêiner de robô conectado ao Orchestrator.