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

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

注:

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

注:

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

構成

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

パラメーター	説明
Orchestrator への接続 (必須)	パッケージがデプロイされる Orchestrator インスタンスへのサービス接続。
パッケージ名 (必須)	Orchestrator のソリューション パッケージ名です。
パッケージ バージョン (必須)	Orchestrator のソリューション パッケージのバージョンです。
デプロイ名 (必須)	作成またはアップグレードするデプロイの名前です。
デプロイの親フォルダー	随意。デプロイ フォルダーが作成される Orchestrator のフォルダーです。指定しない場合、デプロイ フォルダーはテナント フォルダー内に作成されます。指定した場合、デプロイはそれぞれのフォルダーの下に配置されます。「[e-mail] に設定すると、ワークスペース」の場合、デプロイは指定したユーザーの個人用ワークスペースの下に配置されます。
デプロイ フォルダー (必須)	ソリューション ファイルが配置される配置フォルダーの名前です。
設定ファイルのパス	随意。デプロイ時に使用する構成ファイルのパスです。指定しない場合、ソリューション パッケージに関連付けられている既定の構成ファイルが使用されます。
トレース レベル	トレースのログ レベル。既定値は [ Error] です。オプション: None、 Critical、 Error、 Warning、 Information、 Verbose

重要:

Orchestrator のテナント内の任意のレベルで同じ名前のデプロイがすでに存在する場合、この操作により、新しいデプロイが作成されるのではなく、既存のデプロイがアップグレードされます。既存のデプロイが [失敗] ステートの場合、アップグレードは続行されません。失敗したデプロイを解決するかアンインストールしてから、再試行してください。

重要:

テナント レベルでデプロイされたソリューションでは、生成されるフォルダーにユーザーが自動的に割り当てられることはありません。アカウントを割り当てるには、Orchestrator (テナント > フォルダー) で適切な設定が行われていることを確認します。

備考

• ソリューションのデプロイ: このタスクでは、特定の 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'