ソリューションをデプロイおよびアクティブ化する

ソリューション パッケージをソリューションにアップロードしたら、ターゲット フォルダーにデプロイし、アクティブ化して動作させることができます。

デプロイ ワークフロー

ソリューションのデプロイは、次の 2 段階のプロセスです。

1. デプロイ: デプロイ構成を作成し、パッケージをターゲット フォルダーに関連付けます。
2. アクティブ化: デプロイを稼働させ、運用可能にします。

この分離により、デプロイを事前に準備し、メンテナンス ウィンドウ中または手動承認後にアクティブ化できます。

ソリューションをデプロイする

deploy コマンドは、特定の環境にソリューション パッケージのデプロイを作成します。

コマンド構文

uipcli solution deploy <package-name> [options]

パラメーター:

パラメーター	説明	Required
<package-name>	アップロードされたパッケージの名前	はい
-v OR --version	デプロイするパッケージ バージョン	はい
-d OR --deploymentName	このデプロイの名前	はい
-f OR --deploymentFolderName	Orchestrator でのターゲット フォルダー名	はい
-U	Orchestrator URL	はい
-T	テナント名	はい
-A	組織名	はい
-I	外部アプリ ID	はい
-S	外部アプリケーション シークレット	はい
--applicationScope	必要なスコープ	はい
--deploymentParentFolder	ソリューションがデプロイされる Orchestrator の親フォルダー名 (省略すると、ソリューションがテナントにデプロイされます)	いいえ
--configPath	ソリューション構成ファイルへのローカル パス上書きバインドを使用するシナリオで必要	いいえ
--traceLevel	ログ レベル	いいえ

認証

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

例

uipcli solution deploy MySolution \  -v 1.2.3 \  -d MySolution-Prod-v1.2.3 \  -f Production \  -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

デプロイの命名規則

以下を含む意味のあるデプロイ名を選択します。

• ソリューション名
• 環境識別子
• バージョンまたは日付

例:

MySolution-Dev-v1.2.3MySolution-Test-2025-01-15MySolution-Prod-Release-1.2.3InvoiceProcessing-Production-v2.0.0

これにより、複数の環境にわたるデプロイの追跡と管理が容易になります。

デプロイ中の処理

deploy コマンドを実行すると、以下の操作が実行されます。

1. パッケージが [ソリューション] で検証されている。
2. デプロイ設定が作成されます。
3. デプロイはターゲット フォルダーに関連付けられます。
4. 環境固有のバインドが初期化されます。
5. デプロイの準備は整っていますが、まだアクティブになっていません。

ソリューションは、アクティブ化するまでプロセスの実行を開始しません。

デプロイをアクティブ化する

deploy-activate コマンドを使用すると、デプロイがライブかつ運用可能になります。

コマンド構文

uipcli solution deploy-activate <deployment-name> [options]

パラメーター:

パラメーター	説明	Required
<deployment-name>	アクティブ化するデプロイの名前です	はい
-U	Orchestrator URL	はい
-T	テナント名	はい
-A	組織名	はい
-I	外部アプリ ID	はい
-S	外部アプリケーション シークレット	はい
--applicationScope	必要なスコープ	はい
--traceLevel	ログ レベル	いいえ

認証

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

例

uipcli solution deploy-activate MySolution-Prod-v1.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

アクティベーション中の処理

デプロイをアクティブ化すると、以下の処理が行われます。

1. デプロイがターゲット フォルダー内のアクティブなバージョンになります。
2. トリガーがアクティブになります。
3. 同じフォルダー内に以前にアクティブだったデプロイは非アクティブ化されます。

CI/CD パイプラインの統合

完全なデプロイ ワークフロー

steps:  # 1. Pack the Solution  - name: Pack Solution    run: |      uipcli solution pack ./MySolution \        --output ./packages \        --version "1.0.${{ github.run_number }}"  # 2. Upload to Solutions Management  - name: Upload Package    run: |      uipcli solution upload-package ./packages/MySolution.1.0.${{ 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.Packages Solutions.Packages.Write"  # 3. Deploy to target environment  - name: Deploy Solution    run: |      uipcli solution deploy MySolution \        -v "1.0.${{ github.run_number }}" \        -d "MySolution-Prod-v1.0.${{ github.run_number }}" \        -f Production \        -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"  # 4. Activate the deployment  - name: Activate Deployment    run: |      uipcli solution deploy-activate "MySolution-Prod-v1.0.${{ github.run_number }}" \        -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"

手動承認によるゲート デプロイ

デプロイ ステップとアクティブ化ステップを分離して、承認ワークフローを実装できます。

# Stage 1: Deploy (automated)- stage: DeployToProduction  jobs:  - job: Deploy    steps:    - script: |        uipcli solution deploy MySolution -v $(version) -d MySolution-Prod-$(version) -f Production ...      displayName: 'Prepare Production Deployment'# Stage 2: Activate (requires approval)- stage: ActivateProduction  dependsOn: DeployToProduction  # Manual approval gate configured in Azure DevOps  jobs:  - deployment: Activate    environment: 'Production'    steps:    - script: |        uipcli solution deploy-activate MySolution-Prod-$(version) ...      displayName: 'Activate Production Deployment'

マルチ環境の推進

同じバージョンを複数の環境に順番にデプロイします。

# Deploy to Devuipcli solution deploy MySolution -v 1.2.3 -d MySolution-Dev-1.2.3 -f Dev ...uipcli solution deploy-activate MySolution-Dev-1.2.3 ...# Deploy to Testuipcli solution deploy MySolution -v 1.2.3 -d MySolution-Test-1.2.3 -f Test ...uipcli solution deploy-activate MySolution-Test-1.2.3 ...# Deploy to Production (after approval)uipcli solution deploy MySolution -v 1.2.3 -d MySolution-Prod-1.2.3 -f Production ...uipcli solution deploy-activate MySolution-Prod-1.2.3 ...

ロールバック戦略

以前のバージョンにロールバックするには、以下の手順を実行します。

1. 以前のバージョンを新しいデプロイ名でデプロイします。
2. 以前のバージョンのデプロイをアクティブ化します。
3. 必要に応じて、新しいデプロイをアンインストールします。

# Roll back to v1.2.2uipcli solution deploy MySolution -v 1.2.2 -d MySolution-Prod-Rollback-1.2.2 -f Production ...uipcli solution deploy-activate MySolution-Prod-Rollback-1.2.2 ...

次のステップ

ソリューションをデプロイしてアクティブ化したら、以下を行うことができます。

1. Orchestrator で実行を監視します。
2. 不要になったデプロイをアンインストール します。
3. 同じワークフローに従って新しいバージョンをデプロイします。