通知を受け取る

UiPath Robot

UiPath Robot ガイド

Linux 環境のロボット

概要

Linux 環境に対応したロボットを使用して、Docker コンテナーで無人オートメーションを実行できます。この機能を活用すれば、デプロイ規模をさらにすばやく簡単に拡大できます。

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

前提条件

クロスプラットフォーム オートメーションを開発する

Linux ロボットは、UI 操作を必要としない無人オートメーションのみを実行できます。そのため、オートメーションを作成するときには、必ず Cross-platform を選択してください。
このように、クロスプラットフォーム系アクティビティのみが表示され、サポートされていないアクティビティは非表示になります。

クロスプラットフォーム プロジェクトの既定のアクティビティ パッケージを以下に示します。

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

デプロイ

Linux 環境に Unattended ロボットをデプロイするには、以下の手順に従います。

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 Version

Docker Image Tags

2021.10

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

If you encounter issues connecting the robot to Orchestrator, this might be caused by a host machine configuration (e.g. firewall rules). To resolve this, add a specific DNS server in the command.
例: 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
Where 1.1.1.1 refers to the public DNS resolver from Cloudflare. This can be any DNS resolver that can resolve the SignalR Hub.

❗️

重要

  • 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}

ログ

コンテナー インスタンスのライフサイクルを超えてログ ファイルを保持する必要がある場合は、以下のコマンドを使用します。

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

📘

注:

ロボットの 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.

約 21 時間前に更新


Linux 環境のロボット


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。