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.

The Linux robot runs processes developed as cross-platform in Studio that do not require UI Interaction.

Pré-requisitos

• Ambiente Docker
• Conexão de rede com o Orchestrator.
• Machine or Machine Template Key.

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

Create an unattended robot in orchestrator, as shown in this document, then save the machine key so it can be used later.

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 para conectar o robô ao Orchestrator, isso pode ser causado por uma configuração de máquina do 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}
   

Logging

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 Linux do Robô é 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

The command starts a new Robot Container with the Debug feature enabled running on port 8573. After the container is started, you can connect to the docker image using the host machine ip and the port 8573 making use of the Studio Remote Debugging feature.

If you want to debug an already started Robot container you can use the unattended robot connection feature with a robot container connected to the orchestrator.