订阅

UiPath Studio

UiPath Studio 指南

远程调试

自动化在不同计算机上的表现可能有所不同。如果要在生产环境中运行自动化的计算机的配置与设计该自动化的计算机不同(例如,该计算机具有不同的硬件或软件、不同的权限或处于隔离的网络中),则应使用该计算机上的机器人测试并调试流程。

Remote debugging enables you to run and debug attended and unattended processes on robots deployed to remote machines, including on Linux robots that can run cross-platform projects.

您可以使用以下其中一种连接类型连接到远程机器人:

  • Remote Machine - Establish a TCP/IP connection to the robot on the remote machine.
  • Unattended Robot - Connect to an unattended robot in the same tenant using Orchestrator.

Using remote debugging requires that the project is open in Studio. If you are using source control, to make sure you are working with the latest project version, we recommend enabling the Enforce Check-In before Publish design setting.

远程计算机连接

To run or debug a project using a remote machine connection:

  1. 确保满足所有先决条件
  2. 在远程计算机上,配置机器人以接受远程调试请求
  3. 如果在 Orchestrator 中强制执行交互式身份验证,并且您想运行或调试无人值守的流程,请确保远程机器人满足以下条件之一:
    • 已使用交互式登录连接到 Orchestrator。
    • Connected using client credentials or machine key and a user is also signed in from the Assistant.
    • Connected using client credentials or machine key, no user is signed in from the Assistant, and a troubleshooting session is enabled in Orchestrator for the machine from Tenant > Robots > Unattended sessions.
  4. 在 Studio 中:
    1. 设置与远程机器人的连接
    2. 确保已启用远程执行
    3. 运行或调试项目。

先决条件

  • Studio 计算机和远程计算机之间存在 TCP/IP 连接。
  • 远程机器人的版本与 Studio 相同。

在远程计算机上配置机器人

在将远程机器人用于调试之前,必须配置该计算机上的 UiPath.RemoteDebugging.Agent 实用程序,以接受来自 Studio 的远程调试请求:

  1. 导航到安装目录:

    • 对于 Windows 机器人 - 在 UiPath 安装文件夹中打开命令提示符(对于按计算机安装的情形,默认为 %PROGRAMFILES%\UiPath\Studio,按用户安装的情形则为 %localappdata%\Programs\UiPath\Studio)。
    • 对于 Linux 机器人 - 从命令行终端导航到 /root/application
  2. 运行以下命令:

    • 对于 Windows 机器人 - UiPath.RemoteDebugging.Agent.exe enable --port <port_number> --password <pasword> --verbose
    • 对于 Linux 机器人 - ~/application # dotnet ./UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose

    命令中的参数都是可选的:

    • --port <port_number> - 输入用于从 Studio 接收远程调试命令的端口。如果未提供任何端口,则默认使用端口 8573
      该端口必须在防火墙中打开,并且尚未与其他应用程序绑定。
    • --password <password> - 输入在设置与远程调试代理的连接时必须在 Studio 中提供的密码。
    • --verbose - 将额外信息记录到控制台。
  3. 显示以下消息:
    Robot on machine <hostname> is waiting for remote debugging instructions on port <port_number>

  4. Make a note of the hostname and port_number values, they must be provided when setting up the connection in Studio.

在机器人处于远程调试状态时,无法从 Orchestrator 或本地 Assistant 执行任何有人值守或无人值守作业。您甚至可以向未经许可安装机器人的计算机发送远程调试命令。

设置远程计算机连接

  1. 在 Studio 中,选择“调试”选项卡。
  2. 在功能区中,选择“远程调试”下的箭头,然后选择“配置远程调试”以打开“远程调试设置”窗口。
  3. 从“连接类型”下拉列表中,选择“远程计算机”
  4. 在相应的框中提供以下信息:
    • “主机”- 远程计算机的主机名或 IP 地址。
    • “端口”- 要使用的端口。默认端口为 8573
    • “密码”- 在机器人计算机上配置远程调试代理时提供的密码(如适用)。
  5. (可选)要确保可以使用当前设置建立连接,请单击“测试连接”
  6. 单击“保存”

无人值守机器人连接

要使用连接到 Orchestrator 的无人值守机器人远程运行或调试项目,请执行以下操作:

  1. 确保满足所有先决条件
  2. 设置与远程机器人的连接
  3. 确保已启用远程执行
  4. 运行或调试项目。

先决条件

  • Studio 和目标机器人已连接到同一 Orchestrator 租户。
  • Studio, the target robot, and Orchestrator are running version 2021.10 or later. For the robot, 2021.10.6 is the minimum version required for running projects from Studio versions starting with 2021.10.6.
  • 登录到 Studio 的用户有权启动作业,以及在与目标机器人相同的文件夹上下文中创建和删除存储桶和存储文件。此外,机器人帐户必须具有存储桶和存储文件的查看权限。
  • 已配置无人值守机器人,并且计算机具有以下其中一个可用的运行时许可证:无人值守非生产
  • 在调试前台流程时,系统会在 Orchestrator 中为机器人启用“运行前台自动化”选项。
  • If a troubleshooting session is used, it must be enabled only after connecting the robot to the Orchestrator.

设置无人值守机器人连接

  1. 在 Studio 中,选择“调试”选项卡。

  2. 在功能区中,选择“远程调试”下的箭头,然后选择“远程调试设置”

  3. 从“连接类型”下拉列表中,选择“无人值守机器人”

  4. 要使用从 Studio 状态栏选择的 Orchestrator 文件夹中的任何已连接计算机,请单击“保存”。如果要选择要连接的计算机,请使用以下选项:

    • “用户”- 选择将无人值守机器人分配给 Orchestrator 文件夹的帐户。
    • “计算机”- 从 Orchestrator 文件夹中选择计算机或模板。
    • “主机名”- 从已连接的计算机列表中选择一台计算机。

    :information-source: 注意:如果在 Orchestrator 中对帐户设置进行了更改,请使用 Studio 状态栏中的按钮刷新 Orchestrator 连接,以便将其反映在此窗口中。

远程执行

建立远程调试连接后,单击功能区中的“远程调试”按钮可在远程执行和本地执行之间切换。在选择运行或调试操作之前,请确保已启用所需选项(远程或本地)。

  • 只要该按钮以灰色突出显示,所有运行和调试操作(“调试文件”、“运行文件”、“调试项目”、“运行项目”、“进入/跳过/退出”,“测试活动”、“运行至此活动/从此活动运行”)都将在远程机器人上执行。
  • 只要该按钮未以灰色突出显示,所有运行和调试操作都将在本地机器人上执行。

远程调试体验类似于本地调试体验,并且可用于本地调试的所有功能也可用于远程调试。当通过“调试”选项卡触发的远程执行正在进行时,Studio 状态栏将显示为绿色

根据用于远程调试的连接类型,远程机器人会获取执行项目所需的活动包,如下所示:

  • 远程计算机连接 - Studio 将项目依赖项和活动订阅源(包来源)的列表发送到远程机器人,然后远程机器人将使用 Studio 提供的订阅源下载所需的包。
  • 无人值守机器人连接 - Studio 仅将项目依赖项列表发送到远程机器人,然后远程机器人将使用 Orchestrator 订阅源和远程机器人上配置的活动订阅源下载所需的包。

已知限制

  • 使用远程计算机连接时,如果暂停调试的时间较长,Studio 中可能会发生“连接已关闭”错误,即使远程计算机上的连接似乎仍处于活动状态。为避免此问题,您可以增加云端或本地负载均衡器中的 TCP 空闲超时。
  • 使用无人值守机器人连接时,选择“画中画”选项不会在单独的会话中启动执行作业。

关闭远程调试连接

要禁用远程调试连接,请在没有正在进行的调试执行时,打开“远程调试设置”窗口,将“连接类型”设置为“禁用”,然后选择“保存”

约一个月前更新

远程调试


建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。