CI/CD 集成用户指南

上次更新日期 2025年11月17日

UiPath 解决方案部署

UiPath 解决方案部署任务将 UiPath 解决方案包部署到 UiPath Orchestrator 上。这将在特定环境和文件夹结构中创建解决方案包部署。

备注：

目前只有 Automation Cloud 支持解决方案。计划在未来版本中提供对 Automation Suite 的支持。本地部署 (MSI) Orchestrator 不支持解决方案。

备注：

此任务仅与** UiPath.CLI.Windows or UiPath.CLI.Linux` 至少版本 25.10 或更高版本兼容。

配置

使用下表配置 UiPath 解决方案部署输入。

参数	描述
需要 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 "[email protected]'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'- 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'- 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'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'