Linux にインストールする

Linux 上の UiPath Robot の Docker ベースのインストール。イメージ タグ、Linux オートメーションの特徴、Docker 実行パラメーターについて説明します。

Linux に Robot をインストールするには、Docker 環境、Orchestrator へのネットワーク接続、およびマシン テンプレートのクライアント資格情報が必要です。

The Linux Robot image runs RPA processes and test cases from cross-platform projects. Running agents, functions, and API workflows on Linux robots is planned.

The image is for x64 (amd64) hosts only.

Docker イメージのタグ

To install the Docker image of a specific Robot version, mention the tag. To install the latest patch available, do not mention a tag. The command to download the Docker image is:

docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>

Linux のオートメーション - 特徴

• Linux 用のオートメーションを作成するには、Chrome 拡張機能のバージョンが 2021.10.4 以降であることを確認してください。これにより、ロボットはバックグラウンド オートメーションとフォアグラウンド オートメーションを実行できます。
• Linux 用の UI オートメーションを設計する場合、次の入力メソッドをアクティビティで選択できます。
  • Chromium API: 既定の入力モードです。ロボットは Chrome の要素を直接操作できます。
  • クリックをシミュレート/入力をシミュレート: Web ページ上でのクリックや入力といったユーザーの操作をシミュレートします。
• You can also use the following tools:
  • Web レコーダー: Web ページ上での一連のアクションを再現し、ロボットで再生できます。
  • 表抽出: Web の表からデータを簡単に抽出できるツールです。

docker run コマンドのパラメーター

次のリストは、docker run コマンドで使用されるパラメーターをまとめたものです。このコマンドを使用して、Docker イメージを起動します。

• LICENSE_AGREEMENT=accept - UiPath のライセンス契約に同意します。
• ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" - ロボットが接続する Orchestrator インスタンスの URL を設定します。
• CLIENT_ID="$Client_ID" and CLIENT_SECRET="$Client_secret" - Set the client ID and client secret of the machine template.
• MACHINE_KEY="$KEY" - Deprecated. Connects with the key of the machine template instead of the client ID and client secret. Don't combine it with them. Use client credentials instead.
• VNC_ENABLED=true - Optional. Enables the live streaming of the Robot execution on Linux through Virtual Networking Computing (VNC). Requires publishing port 5900 to the host, for example -p 50000:5900, to access the VNC server.
  重要:

  VNC サーバーを有効化した後に、任意の VNC クライアントを使用してロボット実行をライブ ストリーミングします。

次の例は、docker run コマンドの実行方法を示しています。

• クライアント ID とクライアント シークレットを使用する場合

  docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>
  

• VNC_ENABLED=true:

  docker run -e LICENSE_AGREEMENT=accept -e
  ORCHESTRATOR_URL="{orchestrator url}" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -p 50000:5900 --env VNC_ENABLED=true uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>
  

Orchestrator への接続の失敗

ファイアウォール ルールによって Orchestrator への接続がブロックされる場合があります。これに対処するには、docker run コマンドで DNS サーバーを指定します。以下に例を示します。

docker run --dns="1.1.1.1" -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>

値 --dns="1.1.1.1" は Cloudflare からのパブリック DNS リゾルバーを表します。任意の DNS リゾルバーを使用して、SignalR ハブをリダイレクトできます。

パッケージ フィードを設定する

Linux 上のオートメーションには特定のライブラリが必要です。このライブラリは Docker コンテナーの /home/robotuser/.nuget/Packages/ ディレクトリに保存されています。これを構成するには、NuGet ライブラリを含むこのディレクトリをマウントする必要があります。docker run コマンドに -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages/ フラグを追加します。

例:

docker run -e LICENSE_AGREEMENT=accept -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -v <path to packages on the host machine>:/home/robotuser/.nuget/Packages -ti uipathprod.azurecr.io/robot/uiautomation-runtime

重要:

ロボット Linux ユーザー (UID 1000) が、パッケージ フィードを指す、マウントされているパスの読み取り権限を持っていることを確認してください。

リモート デバッグ

実行中のロボット コンテナーをデバッグするには、リモート デバッグ機能を使用します。