構成

UiPath CLI は、 環境変数 とコマンドごとの フラグを使用して構成します。汎用の構成ファイルはありません:ランナーの環境に環境変数を設定し、コマンドにフラグを渡します。

設定ソース

優先順位の高い順に、最も具体的なものから最も一般的なものへと:

1. コマンドラインフラグ — --tenant、 --authority、 --client-id、 --output、 --log-levelなどフラグは他のすべてのソースよりも優先されます。
2. 環境変数 — 実行時にCLIによって読み取られる変数( 環境変数を参照)。CLI は、文書化されたポイントでのみ各変数を読み取ります。暗黙の「すべてのフラグには env-var に対応するものがある」というルールはありません。
3. ハードコードされたデフォルト — https://cloud.uipath.com 、 json は出力形式、 info ログレベル、ページサイズは 50 on list 動詞です。

環境変数

環境変数は、CI ランナー、コンテナー、およびシェルごとの開発者設定で CLI を構成するための主要なメカニズムです。ランナーの環境 (またはランナーによって消費される .env ファイル) で設定すると、CLI は以下に記載されているポイントでそれらを読み取ります。

変数	読み上げ者	目的
UIPATH_URL	uip login、認証されたすべてのコマンド	ID 機関のベース URL を上書きします。既定値は https://cloud.uipath.comです。
UIPATH_CLI_ENABLE_ENV_AUTH	認証されたすべてのコマンド	CLI をファイルベースの資格情報フローから環境変数 auth に切り替えるには、リテラル true に設定します。このゲートをオンにすると、CLI は以下の変数からアクセス トークン + テナント + 組織を読み取り、 ~/.uipath/ credentials フォルダーを完全にバイパスします。「認証 - フロー 3」を参照してください。
UIPATH_CLI_AUTH_TOKEN	env-var 認証フローのみ	JWT アクセス トークン。サーバー URL は、トークンの iss 要求から派生します。
UIPATH_CLI_ORGANIZATION_NAME	env-var 認証フローのみ	組織のスラッグ。
UIPATH_CLI_ORGANIZATION_ID	env-var 認証フローのみ	組織 UUID。
UIPATH_CLI_TENANT_NAME	env-var 認証フローのみ	テナント スラッグ。
UIPATH_CLI_TENANT_ID	env-var 認証フローのみ	テナント UUID。
UIPATH_TELEMETRY_DISABLED	テレメトリの初期化	匿名の使用状況テレメトリをオプトアウトするには、[ 1 ] または [ true ] に設定します。
UIPATH_AI_CONNECTION_STRING	テレメトリの初期化	Application Insights の接続文字列を上書きします。
HTTP_PROXY / http_proxy	ネットワーク層	送信要求 (ホストとツール) の HTTP プロキシ。
HTTPS_PROXY / https_proxy	ネットワーク層	HTTPS プロキシ。
NO_PROXY / no_proxy	ネットワーク層	プロキシ バイパス リスト。

デプロイ間で異なるシークレット以外の値 (テナント、組織、フォルダー名) の場合は、CI ランナーで変数として渡し、 uip コマンドで参照します。

env:
  UIPATH_TENANT: Production
  UIPATH_FOLDER: Shared
script:
  - uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "$UIPATH_TENANT"
  - uip or folders list --all --path "$UIPATH_FOLDER"

警告:

UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET の暗黙的な読み取りなし

環境で UIPATH_CLIENT_ID と UIPATH_CLIENT_SECRET を設定するだけでは、CLI は認証 されません 。1.0より前のバージョンでは、これらが暗黙的に読み取られます。この動作は削除されました。トークン ベースの認証には、--client-id/--client-secretの env.VAR_NAME プレフィックスを使用して明示的に渡すか、上記の env-var 認証フローを使用します。「 認証」をご覧ください。

各設定が生きられる場所

設定	フラグ	環境変数	既定 (Default)
典拠/ベース URL	--authority <url>	UIPATH_URL	https://cloud.uipath.com
外部アプリケーション クライアント ID	--client-id <id>	— (env.VAR_NAMEプレフィックス)	なし
外部アプリのクライアント シークレット	--client-secret <secret>	— (env.VAR_NAMEプレフィックス)	なし
テナント	--tenant <name> (またはセッション)	—	セッションから
フォルダー	--folder-path /コマンドあたり--folder-key	—	なし
出力フォーマット	--output <format>	—	json
出力フィルター	--output-filter <jmespath>	—	なし
ログ レベル	--log-level <level>	—	info
ログ ファイル	--log-file <path>	—	なし
ツールの npm レジストリ	—	—	.npmrc @uipath:registry (設定されている場合)、それ以外の場合は npm default
テレメトリ	—	UIPATH_TELEMETRY_DISABLED=1	enabled

env-var 列のない設定は、フラグを使用してコマンドごとにのみ設定できます。

設定例

最小限のCIランナー(env経由のすべて)

env:
  UIPATH_URL: https://cloud.uipath.com
  UIPATH_CLIENT_ID: ${{ secrets.UIPATH_CLIENT_ID }}
  UIPATH_CLIENT_SECRET: ${{ secrets.UIPATH_CLIENT_SECRET }}
  UIPATH_TENANT: Production
  UIPATH_TELEMETRY_DISABLED: "1"

steps:
  - run: npm install -g @uipath/cli
  - run: uip tools install @uipath/orchestrator-tool @uipath/solution-tool
  - run: |
      uip login \
        --client-id env.UIPATH_CLIENT_ID \
        --client-secret env.UIPATH_CLIENT_SECRET \
        --tenant "$UIPATH_TENANT"
  - run: uip or folders list

事前に発行されたトークンを含むコンテナー (env-var auth flow)

export UIPATH_CLI_ENABLE_ENV_AUTH=true
export UIPATH_CLI_AUTH_TOKEN="$BUILD_TOKEN"
export UIPATH_CLI_ORGANIZATION_NAME=contoso
export UIPATH_CLI_ORGANIZATION_ID="$ORG_UUID"
export UIPATH_CLI_TENANT_NAME=Default
export UIPATH_CLI_TENANT_ID="$TENANT_UUID"

uip or folders list

uip login手順もファイルも書き込まれません。すべてのコマンドは環境変数から認証されます。

参照

• 認証 — 3つの認証フローと、それぞれが読み取る環境変数。
• UiPath CLI をインストールする — プロキシ変数、テレメトリのオプトアウト、CI のインストール パターン。
• セッションと資格情報 — uip loginによって書き込まれた.uipath/資格情報フォルダーです。
• グローバルオプション — 呼び出しごとに環境変数をオーバーライドするフラグ。