robot
2023.10
false
- 发行说明
- 入门指南
- UiPath Assistant
- 安装和升级
- 机器人类型
- 根据许可证
- 有人值守的机器人与无人值守的机器人
- 高密度机器人
- Linux 机器人
- 机器人组件
- 许可
- 将机器人连接到 Orchestrator
- 流程与活动
- 日志记录
- Robot JavaScript SDK
- 特定场景
- 故障排除
机器人用户指南
上次更新日期 2024年12月18日
Linux 机器人
Robot Linux 映像允许您在 docker 容器中运行跨平台自动化。
Robot Linux 映像基于
mcr.microsoft.com/dotnet/runtime
的 Ubuntu Linux 版本。应用程序所需的所有文件都位于 /application/
目录中。
- Docker 环境。
- 与 Orchestrator 的网络连接情况。
- 计算机模板客户端凭据。
若要在 Linux 环境中使用机器人,请在 Orchestrator 中创建一个 Unattended Robot,保存客户端 ID 和客户端密码以便以后使用,然后在机器人计算机上执行以下步骤:
- 打开命令行终端,使用以下命令获取 Docker 映像:
docker pull registry.uipath.com/robot/uiautomation-runtime:<tag>
docker pull registry.uipath.com/robot/uiautomation-runtime:<tag>注意:如果未使用特定标签,系统则会检索最新企业版补丁。要检索或启动 Robot 的特定版本,请将 <tag> 参数替换成下表中“Docker 映像标签”列中的实际版本:机器人版本 Docker 映像标签 2023.10 23.10.69.35238-robot23.10.0 - 根据连接类型,您可以使用以下命令之一启动下载的映像并将机器人连接到 Orchestrator:
重要提示:为了成功启动机器人,您必须通过在命令中添加
-e LICENSE_AGREEMENT=accept
参数来接受许可协议。- 客户端 ID 和客户端密码:
docker 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" -tid registry.uipath.com/robot/uiautomation-runtime:<tag>
docker 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" -tid registry.uipath.com/robot/uiautomation-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/uiautomation-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/uiautomation-runtime:<tag>
- 客户端 ID 和客户端密码:
重要事项:如果您在将机器人连接到 Orchestrator 时遇到问题,则可能是由于主机配置原因(例如,防火墙规则)。要解决此问题,请在命令中添加特定的 DNS 服务器。
DNS 配置示例:
docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid registry.uipath.com/robot/uiautomation-runtime:<tag>
docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid registry.uipath.com/robot/uiautomation-runtime:<tag>
1.1.1.1
是指 Cloudflare 的公共 DNS 解析程序。这可以是能够解析 SignalR Hub 的任何 DNS 解析程序。
重要提示:每次在步骤 2 中运行命令时,系统都会在 Orchestrator 中创建一个新的 Unattended 会话。为避免这种情况,请使用
docker start {container_id}
命令启动已创建的容器。
- 要查看计算机上机器人的状态,请使用以下命令:
docker ps -a
docker ps -a - 如要断开机器人连接,请使用以下命令:
docker stop {container_id}
docker stop {container_id}重要事项:使用docker kill container_id
将在计算机上停止机器人,但不会将其与 Orchestrator 断开连接。 - 要重新连接特定机器人,请使用以下命令:
docker start {container_id}
docker start {container_id}
Linux 机器人可以运行后台和前台(使用 Google Chrome)自动化。
如果要创建与 Linux 机器人兼容的网页自动化,请按照以下步骤操作:
- 新建流程时,请在 Studio 中选择跨平台项目类型。
- 在 Studio 中,从“ 包管理器” 中,将“用户界面自动化”活动包更新为最新版本。 此功能仅从 v21.11.0-preview 包开始提供。 由于您使用的是跨平台项目,因此仅显示支持跨平台项目的活动包。
- 要创建网页自动化,您还需要最新的 Chrome 扩展程序。您可以通过以下方式轻松安装:
注意:在开始设计自动化之前,您必须安装 Chrome 扩展程序 v21.10.4 或更高版本。
为 Linux 机器人设计用户界面自动化项目时,可以对活动使用以下输入方法:
- ChromiumAPI(默认)
- “模拟单击”/“模拟类型”
此外,还支持以下向导:
- 网页记录器
- 表格数据提取
在 Linux 机器人上运行无人值守作业的过程与 Windows 相同。
如果要查看流程的实时执行情况,则可以使用预先配置的 VNC 服务器(可通过
5900
默认端口访问)进行查看。要在流程执行期间连接到该端口,您需要在启动映像时通过向 Docker Run
命令添加 -p {localVncPort}:5900 --env VNC_ENABLED=true
参数来发布 VNC 端口。
docker run -e LICENSE_AGREEMENT=accept -e
ORCHESTRATOR_URL="{orchestrator url}" -e MACHINE_KEY="{machine_key}" -p 50000:5900 --env VNC_ENABLED=true registry.uipath.com/robot/uiautomation-runtime:<tag>
docker run -e LICENSE_AGREEMENT=accept -e
ORCHESTRATOR_URL="{orchestrator url}" -e MACHINE_KEY="{machine_key}" -p 50000:5900 --env VNC_ENABLED=true registry.uipath.com/robot/uiautomation-runtime:<tag>
此命令支持您通过本地计算机 (
50000 port
) 使用 VNC 服务器。之后,您可以使用任何 VNC 客户端实时关注机器人的执行情况。
您可以通过 Unattended Robot 连接功能调试已启动的机器人容器。
与进程执行相关的日志位于 docker 映像的
/home/robotuser/.local/share/UiPath/Logs
文件夹中。
要从容器中提取日志,请使用以下命令:
docker cp <ContainerId>:/home/robotuser/.local/share/UiPath/Logs <TargetPath>
用于在 Linux 机器人上运行自动化的库位于 Docker 容器的
/application/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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-runtime:<tag>
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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-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 on the host machine>:/application/Packages/ -ti registry.uipath.com/robot/uiautomation-runtime:<tag>
其中的
<path to packages>
指主机上的位置。
确保机器人用户(UID 1000 用户)拥有包源已安装路径的读取权限。