Linux 机器人

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

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

先决条件

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

开发跨平台自动化

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

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

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

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

部署

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

Orchestrator 配置

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

客户端计算机

1. 打开命令行终端，使用以下命令获取 Docker 映像：

   docker pull registry.uipath.com/robot/runtimedocker pull registry.uipath.com/robot/runtime:<tag>

2. 使用以下命令启动机器人映像并将机器人连接到 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>

   注意：要检索或启动 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 中生成一个新机器人。

3. 要查看计算机上机器人的状态，请使用以下命令：

   docker ps -a

4. 如要断开机器人连接，请使用以下命令：

   docker stop {container_id}

   重要事项：使用 docker kill container_id 将在计算机上停止机器人，但不会将其与 Orchestrator 断开连接。

5. 要重新连接特定机器人，请使用以下命令：

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

该命令在端口 8573 上运行，以启动启用了调试功能的新机器人容器。启动容器后，您可以利用 Studio 远程调试功能，使用 host machine ip 和端口 8573 连接到 Docker 映像。

如果您想调试已启动的机器人容器，则可以搭配使用 Unattended Robot 连接功能与连接到 Orchestrator 的机器人容器。