Depuración remota

Las automatizaciones pueden comportarse de forma diferente en diferentes máquinas. Si la máquina en la que la automatización se va a ejecutar en producción tiene una configuración diferente a la de la máquina en la que se diseñó (por ejemplo, la máquina tiene hardware o software diferente, diferentes permisos o se encuentra en una red aislada), el proceso debería probarse y depurarse con el UiPath Robot en esa máquina.

La depuración remota te permite ejecutar y depurar procesos atendidos y desatendidos en UiPath Robots implementados en máquinas remotas, incluido en UiPath Robots de Linux que pueden ejecutar proyectos multiplataforma.

Puedes conectarte al UiPath Robot remoto mediante uno de los siguientes tipos de conexión:

• Máquina remota: establece una conexión TCP/IP al UiPath Robot en la máquina remota.
• UiPath Robot desatendido: te conecta a un UiPath Robot desatendido en el mismo tenant mediante Orchestrator.

El uso de la depuración remota requiere que el proyecto esté abierto en Studio. Si usas el control de origen, para asegurarte de que estás trabajando con la versión más reciente del proyecto, te recomendamos habilitar la configuración de diseñoAplicar revisión antes de publicar .

Conexión de una máquina remota

Para ejecutar o depurar un proyecto utilizando una conexión con una máquina remota:

1. Asegúrate de que se cumplen todos los prerrequisitos.
2. En la máquina remota, configura el UiPath Robot para aceptar solicitudes de depuración remotas.

3. Si se aplica la autenticación interactiva en Orchestrator y quieres ejecutar o depurar un proceso desatendido, asegúrate de que el UiPath Robot remoto cumple una de las siguientes condiciones:

   • Está conectado a Orchestrator mediante el inicio de sesión interactivo.
   • Conectado mediante las credenciales de cliente o la clave de máquina y un usuario que también ha iniciado sesión desde UiPath Assistant.
   • Conectado mediante credenciales del cliente o clave de máquina, ningún usuario está conectado desde el Assistant y hay habilitada para solucionar problemas en Orchestrator para la máquina. Para más información, consulta Depuración de procesos unattended.

4. En Studio:

   1. Establece una conexión para el UiPath Robot remoto.
   2. Asegúrate de que la ejecución remota esté habilitada.
   3. Ejecuta o depura tu proyecto.

Requisitos previos

• Existe conectividad TCP/IP entre la máquina de Studio y la máquina remota.
• El UiPath Robot remoto es de la misma versión que Studio.
• El marco .NET compatible se instala en tu máquina remota.

Configurar el UiPath Robot en la máquina remota

Antes de que el UiPath Robot se pueda usar para la depuración, la utilidad UiPath.RemoteDebugging.Agent en esa máquina debe estar configurada para aceptar solicitudes de depuración remotas de Studio:

1. Ve hasta el directorio de instalación:

   • Para un UiPath Robot de Windows: abre un símbolo de sistema en la carpeta de instalación de UiPath (de forma predeterminada, %PROGRAMFILES%\UiPath\Studio para las instalaciones por máquina; %localappdata%\Programs\UiPath\Studio para las instalaciones por usuario).
   • Para un UiPath Robot de Linux: desde un terminal de línea de comandos, ve a /root/application.
   • Para un UiPath Robot macOS: desde zsh, navega hasta /Applications/UiPath Assistant.app/Contents/Robot.

2. Ejecuta el siguiente comando:

   • Para un UiPath Robot de Windows: UiPath.RemoteDebugging.Agent.exe enable --port <port_number> --password <pasword> --verbose
   • Para un UiPath Robot de Linux: ~/application # dotnet ./UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose
   • Para un UiPath Robot macOS: dotnet UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose

     Todos los argumentos en el comando son opcionales:

   • --port <port_number>: especifica el puerto que se utilizará para recibir comandos de depuración remotos desde Studio. Si no se especifica ningún puerto, se utilizará el puerto 8573 de forma predeterminada.

     El puerto deberá estar abierto en el firewall y no deberá estar vinculado a otra aplicación.

   • --password <password>: especifica una contraseña que deberá especificarse luego en Studio al establecer una conexión con el agente de depuración remoto.
   • --verbose: registra información adicional en la consola.

3. Se mostrará entonces el siguiente mensaje:

   Robot on machine <hostname> is waiting for remote debugging instructions on port <port_number>

4. Anota los valores Nombre del host y número_de_puerto, ya que tendrás que proporcionarlos al configurar la conexión en Studio.

Los trabajos no atendidos o desatendidos pueden ejecutarse desde Orchestrator o desde el UiPath Assistant local mientras el UiPath Robot esté en un estado de depuración remota. Puedes enviar comandos de depuración remota incluso a máquinas en las que la instalación del UiPath Robot no tenga licencia.

Configurar una conexión con una máquina remota

1. En Studio, selecciona la pestaña Depurar.
2. En la cinta, selecciona la flecha en Depuración remota y luego selecciona Configurar depuración remota para abrir la ventana Configuración de la depuración remota.
3. En el menú desplegable de Tipo de conexión, selecciona Máquina remota.

4. Facilita la siguiente información en las casillas correspondientes:

   • Host: el nombre de host o la dirección IP de la máquina remota.
   • Puerto: el puerto que se utilizará. El puerto predeterminado es el 8573.
   • Contraseña: la contraseña proporcionada cuando el agente de depuración remota se configuró en la máquina UiPath Robot, si corresponde.
5. (Opcional) Para asegurarte de que se pueda establecer una conexión con la configuración actual, haz clic en Probar conexión.

6. Haz clic en Guardar.

   
   

   

   
   

Conexión de un UiPath Robot desatendido

Para ejecutar o depurar un proyecto de forma remota mediante un UiPath Robot desatendido conectado a Orchestrator:

1. Asegúrate de que se cumplen todos los prerrequisitos.
2. Establece una conexión para el UiPath Robot remoto.
3. Asegúrate de que la ejecución remota esté habilitada.
4. Ejecuta o depura tu proyecto.

Requisitos previos

• Studio y el UiPath Robot de destino deberán estar conectados al mismo tenant de Orchestrator.
• Studio, el UiPath Robot de destino y Orchestrator se ejecutan en la versión 2021.10 o posterior. Para UiPath Robot, 2021.10.6 es la versión mínima requerida para ejecutar proyectos desde versiones de Studio a partir de la 2021.10.6.
• El usuario que ha iniciado sesión en Studio tiene permisos para iniciar trabajos y para crear y eliminar depósitos de almacenamiento y archivos de almacenamiento en el mismo contexto de carpeta que el UiPath Robot de destino. Además, la cuenta del UiPath Robot debe tener permisos de visualización para los depósitos de almacenamiento y los archivos de almacenamiento.

• El UiPath Robot desatendido deberá estar configurado y la máquina deberá tener una de las siguientes licencias de tiempo de ejecución disponibles: Unattended, NonProduction, Testing.

  Nota: Los tiempos de ejecución de las pruebas de depurado remoto son compatibles en Orchestrator 2022.4,
• Para depurar procesos en primer plano, deberá estar habilitada la opción Ejecutar automatizaciones en primer plano para el UiPath Robot en Orchestrator.
• Si se utiliza una sesión de resolución de problemas, debe estar habilitada solo después de conectar el UiPath Robot al Orchestrator.

Configurar una conexión de un UiPath Robot desatendido

1. En Studio, selecciona la pestaña Depurar.
2. En la cinta, selecciona la flecha en Depuración remota y luego selecciona Configurar depuración remota.
3. En el menú desplegable Tipo de conexión, selecciona UiPath Robot desatendido.

4. Para utilizar cualquier máquina conectada que esté disponible en la carpeta seleccionada de Orchestrator en la barra de estado de Studio, haz clic en Guardar. Si quieres seleccionar la máquina a la que se conectará, utiliza las siguientes opciones:

   • Usuario: selecciona una cuenta con un UiPath Robot desatendido asignado a la carpeta de Orchestrator.
   • Máquina: selecciona una máquina o plantilla de la carpeta de Orchestrator.

   • Nombre de host: selecciona una máquina de la lista de máquinas conectadas.

     Nota: Si se realizan cambios en la configuración de la cuenta en Orchestrator, actualiza la conexión de Orchestrator mediante el botón de la barra de estado de Studio para que se reflejen en esta ventana.
     
     

     

     
     

Ejecución remota

Cuando se establece una conexión de depuración remota, hacer clic en el botón Depuración remota en la cinta cambia entre la ejecución remota y la local. Antes de seleccionar una operación de ejecución o depuración, asegúrate de que la opción deseada esté habilitada (remota o local).

• Mientras el botón esté resaltado en gris, todas las operaciones de ejecución y depuración (Depurar archivo, Ejecutar archivo, Depurar proyecto, Ejecutar proyecto, Paso a paso/Saltar paso/Paso para salir, Probar actividad, Ejecutar hasta/desde esta actividad) se realizan en el UiPath Robot remoto.

  
  

  

  
  

• Mientras que el botón no esté resaltado en gris, todas las operaciones de ejecución y depuración se realizarán en el UiPath Robot local.

  
  

  

  
  

La experiencia de depuración remota es similar a la experiencia de depuración local y todas las características disponibles para la depuración local también están disponibles para la remota. Cuando la ejecución remota que se activó desde la pestaña Depuración esté en curso, la barra de estado de Studio apareció en color verde.

Dependiendo del tipo de conexión utilizada para la depuración remota, el UiPath Robot remoto obtiene los paquetes de actividad necesarios para ejecutar un proyecto de la siguiente manera:

• Conexión de una máquina remota: Studio envía la lista de dependencias del proyecto y fuentes de actividad (orígenes de paquetes) al UiPath Robot remoto, que utiliza las fuentes facilitadas por Studio para descargar los paquetes necesarios.
• Conexión del robot unattended: Studio envía solo la lista de dependencias del proyecto al robot remoto, que utiliza las fuentes de Orchestrator y las fuentes de actividad configuradas en el robot remoto para descargar los paquetes necesarios.

Limitaciones conocidas

• Cuando utilizas una conexión de máquina remota, si detienes la depuración durante un largo periodo de tiempo, se puede producir un error de Conexión cerrada en Studio incluso aunque la conexión siga pareciendo estar activa en la máquina remota. Para evitar este problema, puedes aumentar el tiempo de inactividad de TCP en tu equilibrador de carga en las instalaciones o en la nube.
• La depuración remota de flujos de trabajo de larga duración solo es compatible con las conexiones Unattended Robot.
• Cuando utilizas una conexión de UiPath Robot desatendido, seleccionar la opción Imagen en imagen no inicia la ejecución en una sesión separada.

Cerrar una conexión de depuración remota

Para deshabilitar la conexión de depuración remota, cuando no haya ninguna ejecución en curso, abre la ventana Configuración de depuración remota, establece el Tipo de conexión en Deshabilitada y luego selecciona Guardar.