机器人用户指南

上次更新日期 2024年11月11日

Linux 机器人

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

Linux 机器人在 Studio 中运行以跨平台形式开发且不需要用户界面交互的流程。

先决条件

Docker 环境。
与 Orchestrator 的网络连接情况。
计算机或计算机模型密钥。

开发跨平台自动化

Linux 机器人只能运行不需要用户界面的无人值守自动化。为此，在创建自动化时，请确保选择 Cross-platform。

这样，系统将仅显示跨平台活动，而隐藏不支持的活动。

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

UiPath.System.Activities
UiPath.WebAPI.Activities

部署

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

Orchestrator 配置

按照本文档所述，在 Orchestrator 中创建 Unattended Robot，然后保存计算机密钥，以便稍后使用。

客户端计算机

打开命令行终端，使用以下命令获取 Docker 映像：
```
docker pull registry.uipath.com/robot/runtimedocker pull registry.uipath.com/robot/runtime:<tag>docker pull registry.uipath.com/robot/runtimedocker pull registry.uipath.com/robot/runtime:<tag>
```

使用以下命令启动机器人映像并将机器人连接到 Orchestrator：

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

注意：要检索或启动 Robot 的特定版本，请将 <tag> 参数替换成下表中“Docker 映像标签”列中的实际版本：

机器人版本	Docker 映像标签
2021.10	21.10.7 21.10.6 21.10.5 21.10.3

如果未使用任何标签，系统则会检索最新企业版补丁。

重要事项：如果您在将机器人连接到 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 解析程序。

重要提示：

为了成功启动机器人，您必须通过在命令中添加 -e LICENSE_AGREEMENT=accept 参数来接受许可协议。
每次运行第 2 步中显示的命令时，都会在 Orchestrator 中生成一个新机器人。

要查看计算机上机器人的状态，请使用以下命令：
```
docker ps -adocker ps -a
```
如要断开机器人连接，请使用以下命令：
```
docker stop {container_id}docker stop {container_id}
```
重要事项：使用 docker kill container_id 将在计算机上停止机器人，但不会将其与 Orchestrator 断开连接。
要重新连接特定机器人，请使用以下命令：
```
docker start {container_id}docker start {container_id}
```

日志记录

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

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/runtimedocker 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 机器人上运行作业

在 Linux 机器人上运行无人值守作业的过程与 Windows 相同。

远程调试

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

docker run -e LICENSE_AGREEMENT=accept -e DEBUG_SESSION=true -ti -p8573:8573 registry.uipath.com/robot/runtimedocker run -e LICENSE_AGREEMENT=accept -e DEBUG_SESSION=true -ti -p8573:8573 registry.uipath.com/robot/runtime