Downloadkonfiguration für UiPath-Lösung

Die Aufgabe UiPath Solution Download Config lädt eine Lösungskonfiguration vom UiPath Orchestrator herunter. Auf diese Weise können Sie umgebungsspezifische Konfigurationsdateien für im Orchestrator gespeicherte Lösungen abrufen.

Hinweis:

Lösungen werden derzeit nur in der Automation Cloud unterstützt. Die Unterstützung der Automation Suite ist für eine zukünftige Version geplant. Der lokale Orchestrator (MSI) unterstützt keine Lösungen.

Hinweis:

Diese Aufgabe ist nur mit **UiPath.CLI.WindowsorUiPath.CLI.Linux` kompatibel, mindestens Version 25.10 oder höher.

Konfiguration

Verwenden Sie die folgende Tabelle, um die Eingaben der UiPath Solution Download-Konfiguration zu konfigurieren.

Parameter	Beschreibung
Orchestrator-Verbindung (erforderlich)	Eine Dienstverbindung mit der Orchestrator-Instanz.
Paketname (Erforderlich)	Der Name des Lösungspakets von Orchestrator.
Paketversion	Optional. Die Lösungspaketversion von Orchestrator. Wenn nicht angegeben, wird die aktuelle Version verwendet.
Zielpfad (Erforderlich)	Der lokale Pfad, unter dem die heruntergeladene Konfigurationsdatei gespeichert wird.
Filename	Optional. Der Name der lokalen Datei einschließlich der Erweiterung, unter der die heruntergeladene Konfiguration gespeichert wird. Der endgültige Pfad verknüpft Zielpfad und Dateiname.
Dateiformat	Das Format der herunterzuladenden Konfigurationsdatei. Standard: json. Optionen: json, yaml
Ablaufverfolgungsstufe	Die Protokollierungsstufe der Ablaufverfolgung. Standard: Error. Optionen: None, Critical, Error, Warning, Information, Verbose

Hinweise

• Konfigurationsverwaltung: Diese Aufgabe ruft Lösungskonfigurationsdateien ab, die im Orchestrator zur Verwendung in Bereitstellungen gespeichert sind
• Umgebungsspezifische Konfigurationen: Nützlich zum Herunterladen verschiedener Konfigurationsdateien für verschiedene Umgebungen (dev, test, prod)
• Formatflexibilität: Unterstützt sowohl das JSON- als auch das YAML-Konfigurationsformat
• Versionskontrolle: Kann Konfigurationen für bestimmte Paketversionen oder die aktuelle Version herunterladen
• Lokaler Speicher: Lädt Konfigurationen in das lokale Dateisystem herunter, um sie in nachfolgenden Pipelineaufgaben zu verwenden
• Orchestrator-Verbindung: Erfordert eine gültige Dienstverbindung mit der Ziel-Orchestrator-Instanz
• CLI-Kompatibilität: Diese Aufgabe verwendet intern die UiPath-CLI und erfordert eine ordnungsgemäße CLI-Installation auf dem Build-Agenten
• Mindest-CLI-Version: Erfordert die UiPath-CLI-Version 25.10 oder höher für vollständige Kompatibilität
• Integrationsfähig: Heruntergeladene Konfigurationen können mit Bereitstellungsaufgaben für umgebungsspezifische Bereitstellungen verwendet werden

Pipelinebeispiele

Download der Grundkonfiguration

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

Mit Orchestrator-Verbindung und bestimmter Version

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

Vollständige Pipeline: Konfiguration herunterladen und bereitstellen

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'