UiPath ソリューションのデプロイ

[UiPath ソリューションのデプロイ] タスクは、UiPath ソリューション パッケージを UiPath Orchestrator にデプロイします。これにより、特定の環境およびフォルダー構造にソリューション パッケージのデプロイが作成されます。

注:

ソリューションは現在 Automation Cloud でのみサポートされています。Automation Suite のサポートは、今後のリリースで予定されています。オンプレミス (MSI) Orchestrator ではソリューションはサポートされていません。

注:

このタスクは、バージョン 25.10 以降の **UiPath.CLI.WindowsorUiPath.CLI.Linux にのみ対応しています。

構成

次の表を使用して、UiPath ソリューションの Deploy の入力を設定します。

パラメーター	説明
Orchestrator への接続 (必須)	パッケージがデプロイされる Orchestrator インスタンスへのサービス接続。
パッケージ名 (必須)	Orchestrator のソリューション パッケージ名です。
パッケージ バージョン (必須)	Orchestrator のソリューション パッケージのバージョンです。
デプロイ名 (必須)	The name of the deployment to create or upgrade.
デプロイの親フォルダー	Optional. The Orchestrator folder where the deployment folder will be created. If not specified, the deployment folder will be created in tenant folder. When specified, deployment will be under respective folder. When set to "[e-mail]'s workspace", the deployment will be under personal workspace for specified user.
デプロイ フォルダー (必須)	ソリューション ファイルが配置される配置フォルダーの名前です。
設定ファイルのパス	随意。デプロイ時に使用する構成ファイルのパスです。指定しない場合、ソリューション パッケージに関連付けられている既定の構成ファイルが使用されます。
トレース レベル	トレースのログ レベル。既定値は [ Error] です。オプション: None、 Critical、 Error、 Warning、 Information、 Verbose

重要:

If a deployment with the same name already exists at any level within the tenant in Orchestrator, this operation upgrades the existing deployment instead of creating a new one. If the existing deployment is in Failed state, the upgrade does not proceed; resolve or uninstall the failed deployment before retrying.

重要:

Solutions deployed at the tenant level do not automatically assign a user to the resulting folder. To assign an account, ensure the appropriate configuration is set in Orchestrator (Tenant > Folders).

備考

• ソリューションのデプロイ: このタスクでは、特定の Orchestrator 環境にソリューション パッケージのデプロイを作成します。
• パッケージの前提条件: ソリューション パッケージが Orchestrator のソリューション管理にアップロード済みである必要があります。
• フォルダー構造: デプロイ フォルダーを作成または使用して、Orchestrator 内でソリューション ファイルを整理します。
• 構成のサポート: 環境固有の設定用のカスタム構成ファイルをサポートします。
• デプロイ管理: デプロイ名に基づいて、新しいデプロイの作成や既存デプロイの更新を行うことができます。
• CLI の互換性: このタスクでは UiPath CLI を内部で使用するので、ビルド エージェントに適切な CLI をインストールする必要があります。
• CLI の最小バージョン: 完全な互換性を得るには、UiPath CLI バージョン 25.10 以降が必要です。
• 環境のターゲット設定: デプロイ フォルダーを使用すると、特定の環境 (開発、テスト、運用) をターゲットに設定できます。

パイプラインの例

基本的なソリューションのデプロイ

- task: UiPathSolutionDeploy@6  displayName: 'Deploy Solution'  inputs:    orchestratorConnection: 'UiPath-Orchestrator-Connection'    packageName: 'MySolution'    packageVersion: '1.0.$(Build.BuildId)'    deploymentName: 'MySolution-Deployment'    deploymentFolderName: 'Production'    traceLevel: 'Information'

Orchestrator 接続とカスタム構成

- task: UiPathSolutionDeploy@6  displayName: 'Deploy Solution with Custom Config'  inputs:    orchestratorConnection: 'Production-Orchestrator'    packageName: 'MyBusinessSolution'    packageVersion: '2.1.$(Build.BuildNumber)'    deploymentName: 'BusinessSolution-Prod-Deploy'    deploymentParentFolder: 'Production'    deploymentFolderName: 'BusinessApps'    configPath: '$(Build.SourcesDirectory)/configs/production.config'    traceLevel: 'Verbose'

完全なパイプライン: アップロードとデプロイ

variables:  solutionName: 'MyBusinessSolution'  solutionVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'  environmentName: 'Production'steps:- task: UiPathSolutionUploadPackage@6  displayName: 'Upload Solution Package'  inputs:    orchestratorConnection: 'Production-Orchestrator'    solutionPackagePath: '$(Build.ArtifactStagingDirectory)/Packages/$(solutionName).$(solutionVersion).zip'    traceLevel: 'Information'- task: UiPathSolutionDeploy@6  displayName: 'Deploy Solution to $(environmentName)'  inputs:    orchestratorConnection: 'Production-Orchestrator'    packageName: '$(solutionName)'    packageVersion: '$(solutionVersion)'    deploymentName: '$(solutionName)-$(environmentName)-$(Build.BuildNumber)'    deploymentParentFolder: '$(environmentName)'    deploymentFolderName: 'BusinessProcesses'    configPath: '$(Build.SourcesDirectory)/configs/$(environmentName).config'    traceLevel: 'Information'- script: echo "Solution $(solutionName) v$(solutionVersion) deployed to $(environmentName)"  displayName: 'Deployment Summary'