订阅

UiPath 机器人

UiPath 机器人指南

Linux 机器人

About

在 Linux 环境中使用机器人可让您在 Docker 容器中运行无人值守的自动化,并提供更快的体验和更轻松的扩展部署方式。

The Linux robot runs processes developed as cross-platform in Studio that do not require UI Interaction.

先决条件

开发跨平台自动化

Linux 机器人只能运行不需要用户界面的无人值守自动化。为此,在创建自动化时,请确保选择 Cross-platform
这样,系统将仅显示跨平台活动,而隐藏不支持的活动。

450450

跨平台项目的默认活动包为:

  • UiPath.System.Activities
  • UiPath.WebAPI.Activities

部署

要在 Linux 环境中部署无人值守机器人,请按照以下步骤操作:

Orchestrator 配置

Create an unattended robot in orchestrator, as shown in this document, then save the machine key so it can be used later.

客户端计算机

  1. 打开命令行终端,使用以下命令获取 Docker 映像:
docker pull registry.uipath.com/robot/runtime
docker pull registry.uipath.com/robot/runtime:<tag>
  1. Start the robot image and connect the Robot to Orchestrator using the command below:
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/runtime
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/runtime:<tag>

:information-source: To retrieve or start a specific version of the robot, replace the <tag> parameter with the actual version from the Docker Image Tags column in the table below:

Robot VersionDocker Image Tags
2021.1021.10.7
21.10.6
21.10.5
21.10.3

Not using any tag retrieves the most recent enterprise patch for the latest enterprise version.

🚧

Troubleshooting tip

如果您在将机器人连接到 Orchestrator 时遇到问题,则可能是由于主机配置原因(例如,防火墙规则)。要解决此问题,请在命令中添加特定的 DNS 服务器。
示例: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
其中 1.1.1.1 是指 Cloudflare 的公共 DNS 解析程序。这可以是能够解析 SignalR Hub 的任何 DNS 解析程序。

❗️

重要

  • To successfully start the robot, you must accept the license agreement by adding the -e LICENSE_AGREEMENT=accept parameter to the command.

  • 每次运行第 2 步中显示的命令时,都会在 Orchestrator 中生成一个新机器人。

  1. 要查看计算机上机器人的状态,请使用以下命令:
docker ps -a
  1. 如要断开机器人连接,请使用以下命令:
docker stop {container_id}

❗️

重要

使用 docker kill container_id 将在计算机上停止机器人,但不会将其与 Orchestrator 断开连接。

  1. 要重新连接特定机器人,请使用以下命令:
docker start {container_id}

Logging

如果您需要在容器实例的生命周期之外保留日志文件,请使用以下命令:

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

📘

备注:

Robot Linux 映像基于 mcr.microsoft.com/dotnet/runtime 的 Alpine Linux 版本。应用程序所需的所有文件都放置在 /root/application directory 中。

在 Linux 机器人上运行作业

The procedure for running an unattended job on Linux robots is identical to the one for Windows.

远程调试

要测试您的流程,您可以使用以下命令启用调试模式:

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

16 天前更新


Linux 机器人


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

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