Depuração remota

As automações podem se comportar de maneira diferente em máquinas diferentes. Se a máquina na qual uma automação será executada em produção tiver uma configuração diferente da máquina em que ela foi projetada (por exemplo, a máquina possui hardware ou software diferentes, permissões diferentes ou está em uma rede isolada) o processo deve ser testado e depurado com o robô nessa máquina.

A depuração remota permite que você execute e depure processos assistidos e não assistidos em robôs implantados em máquinas remotas, incluindo em robôs do Linux que podem executar projetos multiplataforma.

Você pode se conectar ao robô remoto usando um dos seguintes tipos de conexão:

• Máquina remota — estabeleça uma conexão TCP/IP ao robô na máquina remota.
• Robô não assistido — conecte-se a um robô não assistido no mesmo tenant usando o Orchestrator.

Para usar a depuração remota, é necessário que o projeto esteja aberto no Studio. Se você estiver usando o controle de origem para garantir que está trabalhando com a versão mais recente do projeto, recomendamos habilitar a configuração do design Impor o Check-In antes de Publicar.

Observação:

Você não pode realizar depuração remota em automações codificadas.

Conexão de máquina remota

Para executar ou depurar um projeto usando uma conexão de máquina remota:

1. Certifique-se de que todos os pré-requisitos sejam atendidos.
2. Na máquina remota, configure o robô para aceitar solicitações de depuração remota.
3. Se a autenticação interativa for imposta no Orchestrator e você quiser executar ou depurar um processo não assistido, certifique-se de que o robô remoto atenda a uma das seguintes condições:
   • Conectado ao Orchestrator usando o logon interativo.
   • Conectado usando credenciais de cliente ou chave de máquina, e um usuário também entrou a partir do Assistant.
   • Quando conectado usando credenciais do cliente ou chave da máquina, nenhum usuário é conectado a partir do Assistant e uma sessão de solução de problemas é habilitada no Orchestrator para a máquina. Para obter mais informações, consulte Depuração de processos não assistidos.
4. No Studio:
   1. Configure uma conexão para o Robot remoto.
   2. Certifique-se de que a execução remota está habilitada.
   3. Execute ou depurar seu projeto.

Pré-requisitos

• Existe conectividade TCP/IP entre a máquina do Studio e a máquina remota.
• O robô remoto tem a mesma versão que o Studio.
• A estrutura do .NET compatível está instalada em sua máquina remota.

Configurar o robô na máquina remota

Antes que o robô remoto possa ser usado para depuração, o utilitário UiPath.RemoteDebugging.Agent nessa máquina deve ser configurado para aceitar solicitações de depuração remota do Studio:

1. Navegue até o diretório de instalação:
   • Para um robô do Windows — abra um prompt de comando na pasta de instalação da UiPath (por padrão %PROGRAMFILES%\UiPath\Studio para instalações por máquina, %localappdata%\Programs\UiPath\Studio para instalações por usuário).
   • Para um robô do Linux — a partir de um terminal de linha de comando, navegue até /root/application.
   • Para um Robot macOS - A partir de zsh, navegue até /Applications/UiPath Assistant.app/Contents/Robot.
2. Execute o seguinte comando:
   • Para um robô do Windows - UiPath.RemoteDebugging.Agent.exe enable --port <port_number> --password <pasword> --verbose
   • Para um robô do Linux - ~/application # dotnet ./UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose
   • Para um Robot macOS - dotnet UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose

     Os argumentos no comando são opcionais:

   • --port <port_number> — insira a porta a ser usada para receber comandos de depuração remota do Studio. Se nenhuma porta é fornecida, a porta 85773 é usada por padrão. A porta deve estar aberta no firewall e ainda não estar vinculada a outro aplicativo.
   • --password <password> — insira uma senha que deve ser fornecida no Studio ao configurar uma conexão com o agente de depuração remota.
   • --verbose - Registrar informação extra no console.
3. A seguinte mensagem é exibida: Robot on machine <hostname> is waiting for remote debugging instructions on port <port_number>
4. Anote os valores do hostname e port_number; eles devem ser fornecidos ao configurar a conexão no Studio.

Nenhum trabalho assistido ou não assistido pode ser executado a partir do Orchestrator ou do Assistant local enquanto o robô está em um estado de depuração remota. Você pode enviar comandos de depuração remota até para máquinas em que a instalação do robô não está licenciada.

Configurar uma conexão de máquina remota

1. No Studio, selecione a guia Depurar.

2. Na faixa de opções, selecione a seta em Depuração Remota e, em seguida, selecione Configurar Depuração Remota para abrir a janela Configurações de Depuração Remota.

3. No menu suspenso Tipo de Conexão, selecione Máquina Remota.

4. Forneça as seguintes informações nas caixas correspondentes:

   • Host - O nome do host ou o endereço IP da máquina remota.
   • Porta - A porta a ser usada. A porta padrão é 8573.
   • Senha — a senha fornecida quando o agente de depuração remota foi configurado na máquina do robô, se aplicável.

5. (Opcional) Para se certificar de que uma conexão pode ser estabelecida com a configuração atual, clique em Testar Conexão.

6. Clique em Salvar.

   

Conexão de robôs não assistidos

Para executar ou depurar um projeto remotamente usando um robô não assistido conectado ao Orchestrator:

1. Certifique-se de que todos os pré-requisitos sejam atendidos.
2. Configure uma conexão para o Robot remoto.
3. Certifique-se de que a execução remota está habilitada.
4. Execute ou depurar seu projeto.

Pré-requisitos

• O Studio e o robô de destino estão conectados ao mesmo tenant do Orchestrator.
• O robô remoto tem a mesma versão que o Studio.
• Studio, o robô de destino e o Orchestrator estão executando a versão 2021.10 ou posterior.
• O usuário que entrou no Studio tem permissões para iniciar trabalhos e para criar e excluir buckets de armazenamento e arquivos de armazenamento no mesmo contexto de pasta que o robô de destino. Além disso, a conta do robô deve exibir permissões para buckets de armazenamento e arquivos de armazenamento.
• The unattended robot is configured and the machine has one of the following runtime licenses available: Unattended, NonProduction, Testing.
  Observação:

  Os runtimes de teste para depuração remota são compatíveis com o Orchestrator 2022.4 e posterior.

• Para processos de depuração em primeiro plano, a opção Executar automações em primeiro plano está habilitada para o robô no Orchestrator.
• Se uma sessão de solução de problemas for usada, ela deve ser habilitada apenas após conectar o Robot ao Orchestrator.

Configurar uma conexão de robô não assistido

1. No Studio, selecione a guia Depurar.

2. Na faixa de opções, selecione a seta em Depuração Remota e, em seguida, selecione Configurações de Depuração Remota.

3. No menu suspenso Tipo de Conexão, selecione Robô não assistido.

4. Para usar qualquer máquina conectada que esteja disponível na pasta do Orchestrator selecionada na barra de status do Studio, clique em Salvar. Se você quiser selecionar a máquina à qual vai se conectar, use as seguintes opções:

   • Usuário - Selecione uma conta com um robô não assistido atribuído à pasta do Orchestrator.
   • Máquina - Selecione uma máquina ou modelo da pasta do Orchestrator.
   • Nome do host — selecione uma máquina da lista de máquinas conectadas.
   • Mostrar transmissão ao vivo - Selecione para ver as ações executadas pelo robô. Para obter mais informações, consulte Transmissão ao vivo e controle remoto.
     Observação:

     Se forem feitas alterações na configuração da conta no Orchestrator, atualize a conexão do Orchestrator usando o botão na barra de status do Studio para que elas sejam refletidas nesta janela.

   

Execução remota

Quando uma conexão de depuração remota é estabelecida, clicar no botão Depuração Remota na faixa de opções alterna entre execução remota e local. Antes de selecionar uma operação de execução ou depuração, certifique-se de que a opção desejada esteja habilitada (remota ou local).

• Contanto que o botão esteja realçado em cinza, todas as operações de execução e depuração (Depurar Arquivo, Executar Arquivo, Depurar Projeto, Executar Projeto, Imergir/Saltar/Sair, Testar Atividade, Executar para/a partir desta atividade) são realizadas no robô remoto.

  

• Contanto que o botão não esteja realçado em cinza, todas as operações de execução e depuração são realizadas no robô local.

  

A experiência de depuração remota é semelhante à experiência de depuração local, e todos os recursos disponíveis para a depuração local também estão disponíveis para a depuração remota. Quando a execução remota que foi disparada na guia Depurar está em progresso, a barra de status do Studio fica com cor verde.

Dependendo do tipo de conexão usada para a depuração remota, o robô remoto recebe os pacotes de atividades necessários para executar um projeto da seguinte maneira:

• Conexão de máquina remota — o Studio envia a lista de dependências de projeto e feeds de atividades (origens de pacotes) para o robô remoto, que usa os feeds fornecidos pelo Studio para baixar os pacotes necessários.
• Conexão de UiPath Robot Unattended - o Studio envia apenas a lista de dependências do projeto para o UiPath Robot remoto, que usa os feeds do Orchestrator e os feeds de atividades configurados no UiPath Robot remoto para baixar os pacotes necessários.

Para conexão de robô não assistido, selecionar Mostrar transmissão ao vivo permite que você visualize as ações que o robô está executando em tempo real. Durante a execução remota, uma nova Janela de transmissão ao vivo se abre, a qual você pode mover e redimensionar. Você também pode assumir o controle remoto sem pausar a automação para depuração profunda ou se a execução estiver bloqueada (por exemplo, por elemento de interface gráfica que precise ser clicado). A Janela de transmissão ao vivo desaparece assim que o fluxo de trabalho termina.Embora nenhuma ação adicional seja necessária para os Serverless Automation Cloud Robots, os robôs do Windows exigem a configuração de um servidor VNC.

Observação:

Não é recomendado sair da sua conta durante a depuração remota.

Restrições conhecidas

• A opção Mostrar transmissão ao vivo é suportada apenas para o Automation Cloud Orchestrator e Automation Suite Orchestrator.
• A opção Mostrar transmissão ao vivo funciona apenas se o Serviço de Robôs da UiPath no Unattended Robot for implantado no modo de serviço. Para obter mais informações, consulte Serviço de Robôs da UiPath.
• Ao usar uma conexão de máquina remota, se você pausa a depuração por um período prolongado, um erro Conexão Encerrada pode ocorrer no Studio, mesmo a conexão ainda estando aparentemente ativa na máquina remota. Para evitar esse problema, você pode aumentar o tempo limite ocioso do TCP em sua nuvem ou balanceador de carga no local.
• Os fluxos de trabalho de longa duração de depuração remota são suportados apenas por conexões de Robots unattended.
• Ao usar uma conexão de robô não assistida, selecionar a opção Picture in Picture não inicia a execução em uma sessão separada.
• A opção [Padrão] Cloud Robot - Serverless definida para uma conexão de robô Unattended em um projeto multiplataforma persiste ao alternar para um projeto do Windows, causando um erro de incompatibilidade ao executar o fluxo de trabalho.

Fechar uma conexão de depuração remota

Para desabilitar a conexão de depuração remota, sem que haja nenhuma execução de depuração em progresso, abra a janela Configurações de Depuração Remota, defina o Tipo de Conexão como Desabilitada e selecione Salvar.