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

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

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

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

コマンド構文

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

パラメーター:

パラメーター	説明	Required
<package-path>	.zip パッケージ ファイルへのパスです	はい
-U	Orchestrator URL	はい
-T	テナント名	はい
-A	組織名	はい
-I	外部アプリ ID	はい
-S	外部アプリケーション シークレット	はい
--applicationScope	任意のスコープ (既定値が適用されます)	いいえ
--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	任意のスコープ (既定値が適用されます)	いいえ
--traceLevel	ログ レベル	いいえ

注:

--applicationScope パラメーターを指定せずに外部アプリケーション認証を使用すると、CLI は以下の既定の AutomationSolution スコープを自動的に適用します。

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 one
uipcli 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. ソリューションをターゲット環境にデプロイします 。