Linux 机器人

在 Linux 环境中使用机器人不仅让您可以在 Docker 容器中运行 Unattended 自动化，还能让您轻松扩展部署。

本文档中提及的 Linux 机器人映像只能运行以跨平台形式开发且不需要用户界面交互的流程。要运行需要用户界面的流程，您需要使用专为 Chrome Automation 构建的 Linux Docker 映像。

先决条件

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

开发跨平台自动化

Linux 机器人只能运行无人值守的自动化。创建自动化时，请确保选择跨平台兼容性。这样，系统将仅显示跨平台活动，而隐藏不支持的活动。

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

• UiPath.System.Activities
• UiPath.UIAutomation.Activities

部署

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

Orchestrator 配置

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

客户端计算机

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

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

2. 使用参数启动下载的映像，使用以下命令将 Robot 连接到 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 CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -ti registry.uipath.com/robot/runtime

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

   机器人版本	Docker 映像标签
   2022.4	22.4.68.30958-robot22.4.6

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

   重要事项：如果您在将机器人连接到 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/runtimedocker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -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 机器人上运行自动化的包位于 Docker 容器的 /root/.local/share/UiPath/Packages/ 目录中。如果要为主机配置特定包，可以使用以下命令配置用于持久保存 NuGet 包的卷：

docker run -e LICENSE_AGREEMENT=accept -e MACHINE_KEY="{machine_key}" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -v <path to packages>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/runtimedocker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -v <path to packages>:/root/.local/share/UiPath/Packages/ -ti registry.uipath.com/robot/runtime

其中的 <path to packages> 指主机上的位置。

在 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 的机器人容器。