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 habilita você a executar e depurar processos Attended e Unattended em Robots implantados em máquinas remotas, incluindo em Linux Robots, 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 designImpor o Check-In antes de Publicar .

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 ao 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 Studio, o robô de destino e o Orchestrator estão executando a versão 2021.10 ou posterior. Para o robô, a versão 2021.10.6 é a mínima necessária para executar projetos do Studio na versão 2021.10.6 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.

• O robô não assistido está configurado e a máquina tem uma das seguintes licenças de runtime disponíveis: Não Assistida, NonProduction ou Teste.

  Observação: os runtimes de teste para a depuração remota são suportados no Orchestrator 2022.4 e em versões posteriores.
• 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.

     Observação: se forem feitas alterações na configuração da conta no Orchestrator, atualize a conexão com o Orchestrator usando o botão na barra de status do Studio, para que elas sejam refletidas nessa 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 robô não assistido - O Studio envia apenas a lista de dependências de projeto para o robô remoto, que usa os feeds do Orchestrator e os feeds de atividades configurados no robô remoto para baixar os pacotes necessários.

Restrições conhecidas

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

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.