uip solution pack

「uip solution pack」の構文とオプション - ソリューション ディレクトリまたは '.uis' バンドル ファイルからデプロイ可能な '.zip' を生成します。

uip solution pack は、ソリューション ディレクトリ (.uipx マニフェストを含む) または .uis バンドル ファイルから配置可能な .zip パッケージを生成します。生成されるアーカイブは、uip solution publish がテナント フィードにアップロードしuip solution deploy run、フィードをデプロイできます。

Pack はオフライン操作であり、テナント フィード (または --feed-folderを介した Orchestrator フォルダーのライブラリ フィード) からの NuGet 依存関係を解決する場合を除き、Orchestrator に接続しません。したがって、依存関係の解決がカバーされている限り、まだ完全な資格情報を持たないビルド ステップ内で実行しても安全です。

概要

uip solution pack <solutionPath> [outputPath] \
  [--name <name>] [--version <version>] \
  [--dry-run] \
  [--skip-analyze] [--governance-file-path <path> | --automation-ops-profile <profile>] \
  [--nuget-sources-config-path <path>] [--exclude-configured-sources] [--feed-folder <name>] \
  [--signing-certificate-path <path>] [--signing-certificate-password <password>] [--signing-timestamp-server <url>] \
  [--author <text>] [--description <text>] [--release-notes <text>] [--project-url <url>] \
  [--repository-url <url>] [--repository-commit <sha>] [--repository-branch <branch>] [--repository-type <type>] \
  [--login-validity <minutes>]

このコマンドは 、グローバルオプション を尊重し、 標準の終了コードを返します。

引数

• <solutionPath> (必須) — ソリューション ディレクトリ ( .uipx マニフェストを含む) または .uis ファイルへのパスです。
• [outputPath] (任意) — .zip パッケージが書き込まれる出力ディレクトリです。--dry-runが設定されていない限り必須です。--dry-run指定せずに省略すると、どちらかを追加するためのポインターが表示されて失敗します。

オプション

Core

長押し	値 (Value)	既定 (Default)	説明
-n, --name <name>	text	ソリューションのフォルダー名 (または .uis ファイルのベース名)	パッケージ名。パッケージ化された .zip の名前は <name>_<version>.zipです。
-v, --version <version>	text	1.0.0	パッケージ バージョン。出力ファイル名に表示され、 で deploy run--package-version に渡される値です。
--dry-run	フラグ	無効	使い捨ての一時コピーに対してフル パック パイプライン (リソース同期、実行時依存関係の排出、パッケージャー オプションの検証) を実行し、出力を破棄します。パック時の失敗 (依存関係の欠落、リソース バインディングの破損、アンパック可能なプロジェクトの種類) を、 .zip を生成したりソリューションに書き戻したりすることなくキャッチします。生成されたパッケージの内容物は検査 されないため 、ソリューション フィードが結果を受け入れることを保証することはできません。[outputPath]オプションにします。
--login-validity <minutes>	分	10	更新をトリガーするまでの最小分単位: トークンの有効期限が切れるまでの最小分単位です。依存関係の解決にテナント フィードが必要な場合にのみ関連します。

依存関係の解決

長押し	値 (Value)	既定 (Default)	説明
--nuget-sources-config-path <path>	パス	—	プロジェクトの依存関係を解決するための NuGet ソース構成ファイルへのパスです。
--exclude-configured-sources	フラグ	無効	依存関係は、テナント フィードと --nuget-sources-config-pathからのみ解決します。組み込みの UiPath フィードと nuget.org フィードを削除します。これらのフィードに依存していない依存関係は復元できません。
--feed-folder <name>	名前またはパス	—	すべてのテナント フィードではなく、この Orchestrator フォルダーのライブラリ フィードからの依存関係を解決します。フォルダー名または完全修飾パスを受け入れます。

ガバナンスの分析

--skip-analyze、 --governance-file-path、 --automation-ops-profile は、ソリューション内のすべての RPA プロジェクトに対して実行するワークフロー アナライザーを制御します。--governance-file-path と --automation-ops-profile は相互に排他的です。

長押し	値 (Value)	既定 (Default)	説明
--skip-analyze	フラグ	無効	すべての RPA プロジェクトでワークフロー アナライザーをスキップします。コンパイルと検証は引き続き実行され、アナライザーのルールのみがスキップされます。
--governance-file-path <path>	パス	—	WorkflowCompiler に同梱されているアナライザー ルールではなく、このローカルのガバナンス ポリシー ファイルに対してすべての RPA プロジェクトを分析します。
--automation-ops-profile <profile>	text	—	サインインしているテナントに対して、すべての RPA プロジェクトを Automation Ops でパブリッシュされたガバナンス ポリシーに照らして分析します。値は、ポリシーをダウンロードした 製品 です (例: StudioWeb、 Development、 Business)。

いずれかのガバナンス フラグの空の値 (--governance-file-path "") は間違いとして拒否され、警告なしに「フラグなし」として扱われることはありません。

パッケージの署名

パッケージ済みのプロジェクトの.nupkgに署名するには、PATHの dotnet CLI が必要です。

長押し	値 (Value)	既定 (Default)	説明
--signing-certificate-path <path>	パス	—	.pfxコード署名証明書へのパスです。設定すると、ソリューション内のすべてのパックされたプロジェクト .nupkg 署名されてから、ソリューション .zipにバンドルされます。
--signing-certificate-password <password>	text または env.VAR	—	証明書のパスワード。シェル履歴ではなく環境変数から読み取るように env.ENV_NAME 渡します。
--signing-timestamp-server <url>	URL	—	署名のタイムスタンプ サーバー URL です。

パッケージのメタデータ (ソースの追跡性)

これらのフラグにより、トレーサビリティのメタデータがアーカイブ ルートにある package.metadata.json ファイルと、各プロジェクトの .nuspecにスタンプされます。これらはすべて省略され、パッケージには名前、バージョン、および WorkflowCompiler で必須の 2 つの既定値 (author: "UiPath"、上書きされない場合は description: "Created by UiPath" ) のみが格納されます。

長押し	値 (Value)	既定 (Default)	説明
--author <text>	text	UiPath	パッケージ作成者
--description <text>	text	Created by UiPath	パッケージの説明。
--release-notes <text>	text	—	パッケージのリリース ノート
--project-url <url>	URL	—	Automation Hub のアイデアの URL
--repository-url <url>	URL	—	ソース リポジトリの URL です。
--repository-commit <sha>	text	—	ソース リポジトリのコミット ハッシュ。
--repository-branch <branch>	text	—	ソース リポジトリ ブランチ。
--repository-type <type>	text	git ( --repository-url が設定されている場合)	ソース リポジトリの種類。[ --repository-url ] も設定されている場合にのみ記録されます。

例

最小限

uip solution pack ./my-solution ./dist

ソリューションを ./my-solution で ./dist/my-solution_1.0.0.zip (既定のバージョン) にパックします。

共通 — CI ビルドのピン名とバージョン

uip solution pack ./my-solution ./dist --name invoices --version 1.2.0

./dist/invoices_1.2.0.zip書き込みます。

パッケージ化せずに検証

uip solution pack ./my-solution --dry-run

一時ディレクトリに対してフル パック パイプラインを実行し、出力を破棄します。リソース バインディング、変数参照、ランタイム依存関係のエラーを outputPathなしでキャッチできるため、CI のデプロイ前のゲートとして便利です。

スタンプのソース トレーサビリティ メタデータ

uip solution pack ./my-solution ./dist --version 1.2.0 \
  --repository-url https://github.com/acme/repo \
  --repository-commit abc123 \
  --repository-branch main \
  --release-notes "v1.2.0"

パッケージ化されたプロジェクトに署名する

uip solution pack ./my-solution ./dist --version 1.2.0 \
  --signing-certificate-path ./cert.pfx \
  --signing-certificate-password env.UIPATH_SIGNING_CERTIFICATE_PASSWORD \
  --signing-timestamp-server http://timestamp.digicert.com

ワークフロー アナライザーをスキップ

uip solution pack ./my-solution ./dist --version 1.2.0 --skip-analyze

コンパイルと検証は引き続き実行され、アナライザーのルールのみがスキップされます。

テナントのガバナンス ポリシーに対して分析する

uip solution pack ./my-solution ./dist --version 1.2.0 --automation-ops-profile Development

スクリプティング — パブリッシュ ステップの出力パスをキャプチャします。

PKG=$(uip solution pack ./my-solution ./dist --version 1.2.0 --output-filter "Data.Packages" --output plain)
uip solution publish "$PKG"

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

リアルパック:

{
  "Code": "SolutionPack",
  "Data": {
    "Package": "my-solution@1.2.0",
    "Packages": "./dist/my-solution_1.2.0.zip"
  }
}

• Package — パックされたソリューションの <name>@<version> 識別子です。
• Packages — <outputPath>に書き込まれる.zipパスのコンマ区切りのリストです。通常は 1 つのパスです。

ドライ ラン (--dry-run):

{
  "Code": "SolutionPack",
  "Data": {
    "Package": "my-solution@1.0.0",
    "DryRun": true,
    "Status": "Valid"
  }
}

故障モード

• --dry-runなしでoutputPathが欠落しています。出力ディレクトリを指定するか、 を渡すためのポインターで失敗 --dry-run。
• 競合するガバナンス フラグ。--governance-file-path と --automation-ops-profile は相互に排他的です。どちらも空の値は拒否されます。
• メンバー プロジェクト ディレクトリ内の出力パスです。拒否された — そこに書かれたものはすべて、次のパックでそのプロジェクト独自のパッケージに詰め込まれます。ソリューションのプロジェクト ディレクトリの外部にある出力パスを選択します (たとえば、ソリューションのルートにある ./out 、またはソリューションの完全な外部にあるディレクトリ)。
• アンパック可能なプロジェクトの種類。プロジェクトの種類に名前を付け、 uip tools search / uip tools install <tool> をポイントして、そのパッケージを処理するパッケージャー ツールを追加します (新しく追加された種類の場合は最初に uip update します)。

関連コマンド

• uip solution publish — パッケージ化された.zipをテナントのソリューション フィードにアップロードします。
• uip solution upload — ソリューションをデプロイ用にパッケージ化するのではなく、対話型の編集用に Studio Web にアップロードする代替パスです。
• uip solution deploy run — パブリッシュされたパッケージを Orchestrator にデプロイします。

参照

• 最初のパイプライン — パック→パブリッシュ→デプロイの実行ウォークスルー。
• uip solutionの概要。