ソリューション パッケージをアップロードおよび削除する

ソリューションをパッケージ化したら、そのパッケージを Orchestrator の [ソリューション] にアップロードできます。不要になったパッケージを削除することもできます。

パッケージをアップロードする

upload-package コマンドは、ソリューション .zip ファイルをソリューションにプッシュします。

コマンド構文

uipcli solution upload-package <package-path> [options]

パラメーター:

パラメーター	説明	Required
<package-path>	.zip パッケージ ファイルへのパスです	はい
-U	Orchestrator URL	はい
-T	テナント名	はい
-A	組織名	はい
-I	外部アプリ ID	はい
-S	外部アプリケーション シークレット	はい
--applicationScope	Optional scopes (defaults applied)	いいえ
--traceLevel	ログ レベル	いいえ

認証

必要なスコープについては、「 認証とスコープ 」および「外部アプリの設定」をご覧ください。

例

uipcli solution upload-package C:\Output\MySolution.1.2.3.zip \  -U https://cloud.uipath.com/ \  -T DefaultTenant \  -A myorg \  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \  -S **** \  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \  --traceLevel Information

CI/CD シークレットを使用する

スクリプトに資格情報をハードコーディングしないでください。プラットフォームのシークレット管理を使用する:

Azure DevOps:

- script: |    uipcli solution upload-package $(Build.ArtifactStagingDirectory)\MySolution.$(Build.BuildId).zip \      -U $(orchestratorUrl) \      -T $(orchestratorTenant) \      -A $(organizationName) \      -I $(externalAppId) \      -S $(externalAppSecret) \      --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \      --traceLevel Information  displayName: 'Upload Solution Package'

GitHub Actions:

- name: Upload Solution Package  run: |    uipcli solution upload-package ${{ runner.temp }}/packages/MySolution.${{ github.run_number }}.zip \      -U ${{ secrets.ORCHESTRATOR_URL }} \      -T ${{ secrets.ORCHESTRATOR_TENANT }} \      -A ${{ secrets.ORG_NAME }} \      -I ${{ secrets.EXTERNAL_APP_ID }} \      -S ${{ secrets.EXTERNAL_APP_SECRET }} \      --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \      --traceLevel Information

アップロード後の処理

アップロードされたパッケージには以下のような特徴があります。

• Orchestrator の [ソリューション] に表示されます。
• 任意のターゲット フォルダーにデプロイできます。
• バージョン管理され、追跡されます。
• 他のパイプラインまたはユーザーがダウンロードできます。

パッケージを削除する

delete-package コマンドは、[ソリューション] からソリューション パッケージを削除します。

コマンド構文

uipcli solution delete-package <package-name> [options]

パラメーター:

パラメーター	説明	Required
<package-name>	パッケージの名前 (拡張子 .zip 除く)	はい
-v OR --version	削除するバージョン番号	はい
-U	Orchestrator URL	はい
-T	テナント名	はい
-A	組織名	はい
-I	外部アプリ ID	はい
-S	外部アプリケーション シークレット	はい
--applicationScope	Optional scopes (defaults applied)	いいえ
--traceLevel	ログ レベル	いいえ

注:

When using external application authentication without specifying the --applicationScope parameter, the CLI automatically applies these default AutomationSolution scopes:

Solutions.Packages Solutions.Deployments OR.Execution

認証

必要なスコープについては、「 認証とスコープ 」および「外部アプリの設定」をご覧ください。

例

uipcli solution delete-package MySolution \  -v 1.2.3 \  -U https://cloud.uipath.com/ \  -T DefaultTenant \  -A myorg \  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \  -S **** \  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \  --traceLevel Information

パッケージを削除するタイミング

パッケージを削除する場合の一般的なシナリオは次のとおりです。

• パイプラインをクリーンアップ - デプロイが正常に完了したら古いバージョンを削除します。
• 失敗したビルド - デプロイすべきでない無効なパッケージを削除します。
• 保持ポリシー - パッケージのライフサイクル ルールを適用します (例: 最新の 10 バージョンのみを保持する)。
• ストレージの管理 - ソリューションの領域を解放します。

パイプラインの例 - 古いバージョンをクリーンアップする

# Delete old version after deploying new oneuipcli solution delete-package MySolution \  -v 1.2.2 \  -U https://cloud.uipath.com/ \  -T DefaultTenant \  -A myorg \  -I $(externalAppId) \  -S $(externalAppSecret) \  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"

パッケージの命名

アップロード操作と削除操作で使用されるパッケージ名は、ファイル名ではなくソリューション名から派生します。

例：

• pack コマンドは以下を作成します MySolution.1.2.3.zip
• 削除するパッケージ名: MySolution
• バージョン: 1.2.3

次のステップ

パッケージをアップロードした後、以下を実行できます。

1. デプロイ構成をダウンロードします。
2. ソリューションをターゲット環境にデプロイします 。