Linux 環境のロボット

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

このドキュメントに記載されている Linux ロボットのイメージで実行できるのは、UI 操作を必要としない、クロスプラットフォームとして開発されたプロセスのみです。ユーザー インターフェイスが必要なプロセスを実行するには、Chrome オートメーション用に構築された Linux Docker イメージを使用する必要があります。

前提条件

• Docker 環境
• Orchestrator へのネットワーク接続
• マシンまたはマシン テンプレート キー

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

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

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

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

デプロイ

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

Orchestrator の設定

こちらのドキュメントに示すように、Orchestrator でUnattended ロボットを作成して、後から使用できるようにマシン キーを保存します。

クライアント マシン

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}

ログ

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

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

このコマンドは、ポート 8573 で動作し、デバッグ機能が有効化されている、新しいロボット コンテナーを起動します。コンテナーが起動したら、Studio のリモート デバッグ機能を使用し、host machine ip およびポート 8573 を使用して Docker イメージに接続できます。

既に起動しているロボット コンテナーをデバッグする場合は、Orchestrator に接続されているロボット コンテナーで Unattended ロボット接続機能を使用できます。