Configuration du téléchargement de la solution UiPath

Tâche UiPath Solution Download Config pour récupérer les fichiers de configuration de solution à partir d'Orchestrator via Azure DevOps.

La tâche UiPath Solution Download Config télécharge une configuration de solution à partir d'UiPath Orchestrator. Cela vous permet de récupérer des fichiers de configuration spécifiques à l'environnement pour les solutions stockées dans Orchestrator.

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 Config de téléchargement de solution UiPath.

Paramètre	Description
Connexion Orchestrator (Orchestrator connection) (obligatoire)	Connexion de service à l’instance d’Orchestrator.
Nom du package (requis)	Le nom du package de solutions d’Orchestrator.
Version de paquet (Package Version)	Facultatif. La version du package de solutions d’Orchestrator. Si elle n’est pas spécifiée, la version la plus récente sera utilisée.
Chemin de destination (requis)	Le chemin d’accès local où le fichier de configuration téléchargé sera enregistré.
Filename	Facultatif. Le nom de fichier local, y compris l’extension, où la configuration téléchargée sera enregistrée. Le chemin final concatène le chemin de destination et le nom de fichier.
Format de fichier	Le format du fichier de configuration à télécharger. Par défaut : json. Options : json, yaml
Niveau du traçage	Niveau de journalisation du traçage. Par défaut : Error. Options : None, Critical, Error, Warning, Information, Verbose

Remarques

• Gestion de la configuration: cette tâche récupère les fichiers de configuration de solution stockés dans Orchestrator pour être utilisés dans les déploiements
• Configurations spécifiques à l'environnement: utiles pour télécharger différents fichiers de configuration pour différents environnements (dev, test, prod)
• Flexibilité du format: prend en charge les formats de configuration JSON et YAML
• Contrôle de version: peut télécharger les configurations pour des versions de package spécifiques ou la version la plus récente
• Stockage local: télécharge les configurations dans le système de fichiers local pour les utiliser dans les tâches de pipeline ultérieures
• Connexion à Orchestrator: Nécessite une connexion de service valide à l'instance Orchestrator cible
• 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
• Intégration prête: les configurations téléchargées peuvent être utilisées avec des tâches de déploiement pour des déploiements spécifiques à un environnement

Exemples de pipelines

Téléchargement de la configuration de base

- task: UiPathSolutionDownloadConfig@6
  displayName: 'Download Solution Configuration'
  inputs:
    orchestratorConnection: 'UiPath-Orchestrator-Connection'
    packageName: 'MySolution'
    destinationPath: '$(Build.ArtifactStagingDirectory)/configs'
    traceLevel: 'Information'

Avec connexion Orchestrator et version spécifique

- task: UiPathSolutionDownloadConfig@6
  displayName: 'Download Production Configuration'
  inputs:
    orchestratorConnection: 'Production-Orchestrator'
    packageName: 'MyBusinessSolution'
    packageVersion: '2.1.$(Build.BuildNumber)'
    destinationPath: '$(Build.SourcesDirectory)/configs'
    filename: 'production-config.json'
    format: 'json'
    traceLevel: 'Verbose'

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

variables:
  solutionName: 'MyBusinessSolution'
  solutionVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'
  environmentName: 'Production'

steps:
- task: UiPathSolutionDownloadConfig@6
  displayName: 'Download $(environmentName) Configuration'
  inputs:
    orchestratorConnection: 'Production-Orchestrator'
    packageName: '$(solutionName)'
    packageVersion: '$(solutionVersion)'
    destinationPath: '$(Build.ArtifactStagingDirectory)/configs'
    filename: '$(environmentName)-config.yaml'
    format: 'yaml'
    traceLevel: 'Information'

- task: UiPathSolutionDeploy@6
  displayName: 'Deploy Solution with Downloaded Config'
  inputs:
    orchestratorConnection: 'Production-Orchestrator'
    packageName: '$(solutionName)'
    packageVersion: '$(solutionVersion)'
    deploymentName: '$(solutionName)-$(environmentName)-$(Build.BuildNumber)'
    deploymentParentFolder: '$(environmentName)'
    deploymentFolderName: 'BusinessProcesses'
    configPath: '$(Build.ArtifactStagingDirectory)/configs/$(environmentName)-config.yaml'
    traceLevel: 'Information'

- script: echo "Downloaded and used configuration for $(solutionName) v$(solutionVersion)"
  displayName: 'Configuration Summary'