Déploiement de la solution UiPath

La tâche de déploiement de la solution UiPath déploie un package de solution UiPath sur UiPath Orchestrator. Cela crée un déploiement d’un package de solution dans un environnement et une structure de dossiers spécifiques.

Remarque :

Les solutions ne sont actuellement prises en charge que dans Automation Cloud. La prise en charge d’Automation Suite est prévue pour une version future. On-Premises (MSI) Orchestrator ne prend pas en charge les solutions.

Remarque :

Cette tâche est compatible uniquement avec **UiPath.CLI.WindowsorUiPath.CLI.Linux`au moins la version 25.10 ou une version ultérieure.

Configuration

Utilisez la table suivante pour configurer les entrées de déploiement de solution UiPath.

Paramètre	Description
Connexion Orchestrator (Orchestrator connection) (obligatoire)	Connexion de service à l’instance d’Orchestrator vers laquelle le package va être déployé.
Nom du package (requis)	Le nom du package de solutions d’Orchestrator.
Version du package (requis)	La version du package de solutions d’Orchestrator.
Nom du déploiement (requis)	Le nom du déploiement à créer ou à mettre à niveau.
Dossier parent de déploiement	Facultatif. Le dossier Orchestrator dans lequel le dossier de déploiement sera créé. S'il n'est pas spécifié, le dossier de déploiement sera créé dans le dossier du locataire. Lorsqu'il est spécifié, le déploiement se fera sous le dossier respectif. Lorsqu'il est défini sur «[e-mail] » l’espace de travail), le déploiement sera sous l’espace de travail personnel de l’utilisateur spécifié.
Dossier de déploiement (requis)	Nom du dossier de déploiement où les fichiers de solutions seront placés.
Chemin du fichier de configuration	Facultatif. Chemin d’accès à un fichier de configuration à utiliser pendant le déploiement. S'il n'est pas spécifié, le fichier de configuration par défaut associé au package de solution sera utilisé.
Niveau du traçage	Niveau de journalisation du traçage. Par défaut : Error. Options : None, Critical, Error, Warning, Information, Verbose

Important :

Si un déploiement portant le même nom existe déjà à n'importe quel niveau au sein du locataire dans Orchestrator, cette opération met à niveau le déploiement existant au lieu d'en créer un nouveau. Si le déploiement existant est à l'état Échec, la mise à niveau ne se poursuit pas ; résolvez ou désinstallez le déploiement ayant échoué avant de réessayer.

Important :

Les solutions déployées au niveau du locataire n’affectent pas automatiquement un utilisateur au dossier résultant. Pour attribuer un compte, assurez-vous que la configuration appropriée est définie dans Orchestrator (Locataire > Dossiers).

Remarques

• Déploiement de la solution: cette tâche crée des déploiements de packages de solution dans des environnements Orchestrator spécifiques.
• Prérequis du package: nécessite que le package de solution soit déjà téléchargé vers Solutions Management dans Orchestrator.
• Structure de dossier: crée ou utilise des dossiers de déploiement pour organiser les fichiers de solution dans Orchestrator.
• Prise en charge de la configuration: prend en charge les fichiers de configuration personnalisés pour les paramètres spécifiques à un environnement.
• Gestion des déploiements: peut créer de nouveaux déploiements ou mettre à jour les déploiements existants en fonction du nom du déploiement.
• Compatibilité CLI: cette tâche utilise la CLI UiPath en interne et nécessite une installation CLI appropriée sur l’agent de développement.
• Version minimale de la CLI: nécessite la version 25.10 ou une version supérieure de la CLI UiPath pour une compatibilité complète.
• Ciblage de l'environnement: les dossiers de déploiement permettent de cibler des environnements spécifiques (dev, test, prod).

Exemples de pipelines

Déploiement de la solution de base

- 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'

Avec connexion Orchestrator et configuration personnalisée

- 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'

Pipeline terminé : téléchargez et déployez

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'