Linux 環境のロボット

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

The Linux robot image referenced in this document can only run processes developed as cross-platform that do not require UI Interaction. To run processes that require a user interface, you need to use the Linux docker image built for Chrome Automation.

前提条件

• Docker 環境
• Orchestrator へのネットワーク接続
• Machine or Machine Template Key.

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

Linux ロボットは無人オートメーションのみを実行できます。オートメーションを作成する際は、クロスプラットフォームを選択してください。これにより、クロスプラットフォーム プロセスで使用できるアクティビティのみが表示され、サポートされていないアクティビティは非表示になります。

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

• UiPath.System.Activities
• UiPath.UIAutomation.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/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
   

   注:

   特定のバージョンのロボットを取得または起動するには、<tag> パラメーターを下表の「Docker イメージのタグ」列に記載されている実際のバージョンで置き換えます。

   Robot のバージョン	Docker イメージのタグ
   2022.4	22.4.68.30958-robot22.4.6

   タグを使用しないと、最新の Enterprise のバージョンの最新の Enterprise のパッチが取得されます。

   重要:

   ロボットを 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 ハブを解決できる任意の 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}
   

Logging

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

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

注:

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

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 Robocontainer, you can use the unattended roboot connection feature with a robot container connected to the orchestrator.