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.

The Linux robot image referenced in this document can only run processes developed as cross-platform that do not require UI Interaction. To run processes that require a user interface, you need to use the Linux docker image built for Chrome Automation.

Pré-requisitos

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

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

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

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

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 Robocontainer, you can use the unattended roboot connection feature with a robot container connected to the orchestrator.