UIP エージェントのパブリッシュ

uip agent publish エージェント プロジェクトをパッケージ化し、生成されたパッケージを新しいソリューション パッケージのバージョンとして Orchestrator にプッシュします。返されたPackageVersionKeyは、uip agent deployへの入力です。

内部的には、 publish は複数ステージのパイプラインを実行します。

1. 入力がディレクトリの場合、プロジェクト構造を検証し、一時 .uisにパックします。
2. .uisを抽出し、任意のagent.json/resource.jsonを期待されるstorageVersion (現在は44.0.0) まで移行して、再梱包します。
3. uip solution pack にシェルアウトしてソリューション .zip (1 つまたは複数の .nupkg ファイルを含む) を生成します。
4. 標準のソリューション API (既定) を介してソリューションをアップロードするか、 --direct が設定されている場合は Orchestrator のパッケージ フィードに直接アップロードします。

アクティブな CLI セッション (uip login) が必要です。

概要

uip agent publish [path] [-t <tenant>] [-l <locationKey>] [-n <name>]
                  [--package-version <version>]
                  [--folder-id <id>] [--direct]
                  [--login-validity <minutes>]

すべての uip agent publish 呼び出しでは、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) が優先されます。終了コードは 標準コントラクトに従います。

引数

• [path] (任意、デフォルト .) — エージェントのプロジェクトディレクトリ または パック済みの .uis ファイルへのパスです。.uis入力では、pack ステップがスキップされます。ダウンストリームのすべて (移行、再梱包、ソリューション パック、アップロード) は引き続き実行されます。

オプション

フラグ	既定 (Default)	目的
-t, --tenant <tenant>	テナントにログイン	対象のテナント。ログイン セッションに既定のテナントがない場合は必須です。
-l, --location-key <guid>	—	ソリューション API packagesUpload 呼び出しに転送する任意の GUID (既定のアップロード パスでのみ使用)
-n, --name <name>	エージェント metadata.name → パスのベース名	パッケージ名。Orchestrator での .uis / .zip ファイル名とパッケージ名になります。
--package-version <version>	1.0.0	アップロードされるパッケージのバージョン文字列です。
--folder-id <id>	ログインフォルダの組織単位 ID	Orchestrator フォルダーの組織単位 ID--directが設定されている場合にのみ参照されます。既定のソリューションのアップロード パスでは無視されます。
--direct	無効	各 .nupkg を Orchestrator のパッケージ フィードに直接アップロードし、ソリューション API をバイパスしてパッケージごとの Release を作成します。ソリューションのデプロイ パスが失敗した場合、またはリリースを特定のフォルダーにすぐに作成する場合は、こちらをご覧ください。
--login-validity <minutes>	10	トークンの有効期間は、最小時間 (分) です。「 認証」をご覧ください。

例

# Publish the current project to the login tenant
uip agent publish --package-version 1.0.0

# Publish a specific project folder
uip agent publish ./my-agent --package-version 1.0.0

# Publish a pre-packed .uis
uip agent publish ./dist/my-agent.uis --package-version 1.0.0

# Direct upload into a specific folder (creates releases in that folder)
uip agent publish ./my-agent \
  --package-version 1.1.0 \
  --direct --folder-id 42

# Override tenant and name
uip agent publish ./my-agent \
  -t production \
  -n invoice-agent \
  --package-version 2.0.0

データシェイプ(--output json)

既定のアップロード パス (Code: "AgentPublish"):

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published successfully",
    "Name": "my-agent",
    "Version": "1.0.0",
    "PackageVersionKey": "a1b2c3d4-0000-0000-0000-000000000050"
  }
}

PackageVersionKey は、ユーザーが uip agent deployに渡すものです。

--direct パス

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published to Orchestrator (direct)",
    "Name": "my-agent",
    "Version": "1.0.0",
    "Releases": [
      {
        "Name": "InvoiceAgent",
        "Key": "a1b2c3d4-0000-0000-0000-000000000055",
        "ProcessKey": "com.uipath.agent.InvoiceAgent"
      }
    ]
  }
}

--directモードでは、ソリューション .zip内の各.nupkgが個別にアップロードされ、リリースがパッケージごとに作成されます。PackageVersionKeyはありません。対応する概念は、リリースごとのKeyであり、uip agent run startで直接使用できます。

移行動作

publishstorageVersionが 44.0.0以下であることが予期されますが、新しい Studio Web プロジェクト47.0.0される場合があります。再パックする前に、一時抽出ディレクトリ内の agent.json ファイルとツール ファイルの resource.json ファイルを予期されるスキーマにサイレント モードで書き換えます。ディスク上のプロジェクトは変更されません。

移行されたファイルごとに、 Message ログ エントリ (例: Migrated /tmp/…/agent.json: storageVersion 47.0.0 → 44.0.0) が生成されます。

関連

• uip agent pack — ローカル梱包ステップ (内部に含まれる)
• uip agent deploy — アップロードしたパッケージ バージョンをインストールしてアクティブ化します。
• uip agent validate — パブリッシュする前に、ディスク上のプロジェクトに対して静的なチェックと移行を実行します。

参照

• 認証 — セッション、テナント、および --login-validity。
• Orchestrator: ジョブ — 解放されたエージェント プロセスが最終的に実行される場所。
• グローバル オプション、 終了コード。