Bereitstellung der UiPath-Lösung

Die Aufgabe UiPath Solution Deploy stellt ein UiPath-Lösungspaket auf UiPath Orchestrator bereit. Dadurch wird eine Bereitstellung eines Lösungspakets in einer bestimmten Umgebung und Ordnerstruktur erstellt.

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 von UiPath Solution Deploy zu konfigurieren.

Parameter	Beschreibung
Orchestrator-Verbindung (erforderlich)	Eine Dienstverbindung mit der Orchestrator-Instanz, auf der das Paket bereitgestellt wird.
Paketname (Erforderlich)	Der Name des Lösungspakets von Orchestrator.
Paketversion (Erforderlich)	Die Lösungspaketversion von Orchestrator.
Name der Bereitstellung (Erforderlich)	Der Name der Bereitstellung, die erstellt oder aktualisiert werden soll.
Übergeordneter Ordner der Bereitstellung	Optional. Der Orchestrator-Ordner, in dem der Bereitstellungsordner erstellt wird. Wenn nicht angegeben, wird der Bereitstellungsordner im Mandantenordner erstellt. Wenn angegeben, erfolgt die Bereitstellung im jeweiligen Ordner. Wenn auf „ [e-mail]“ festgelegt ist workspace" befindet sich die Bereitstellung im persönlichen Arbeitsbereich für den angegebenen Benutzer.
Bereitstellungsordner (Erforderlich)	Der Name des Bereitstellungsordners, in dem Lösungsdateien abgelegt werden.
Pfad der Konfigurationsdatei	Optional. Der Pfad zu einer Konfigurationsdatei, die während der Bereitstellung verwendet werden soll. Wenn nicht angegeben, wird die dem Lösungspaket zugeordnete Standardkonfigurationsdatei verwendet.
Ablaufverfolgungsstufe	Die Protokollierungsstufe der Ablaufverfolgung. Standard: Error. Optionen: None, Critical, Error, Warning, Information, Verbose

Wichtig:

Wenn eine Bereitstellung mit demselben Namen bereits auf beliebiger Ebene innerhalb des Mandanten im Orchestrator vorhanden ist, aktualisiert dieser Vorgang die vorhandene Bereitstellung, anstatt eine neue zu erstellen. Wenn sich die vorhandene Bereitstellung im Status „Fehlgeschlagen“ befindet, wird das Upgrade nicht fortgesetzt; können Sie die fehlgeschlagene Bereitstellung beheben oder deinstallieren, bevor Sie es erneut versuchen.

Wichtig:

Lösungen, die auf Mandantenebene bereitgestellt werden, weisen dem resultierenden Ordner nicht automatisch einen Benutzer zu. Um ein Konto zuzuweisen, stellen Sie sicher, dass die entsprechende Konfiguration im Orchestrator festgelegt ist (Mandant > Ordner).

Hinweise

• Lösungsbereitstellung: Diese Aufgabe erstellt Bereitstellungen von Lösungspaketen in bestimmten Orchestrator-Umgebungen.
• Paketvoraussetzung: Erfordert, dass das Lösungspaket bereits in die Lösungsverwaltung im Orchestrator hochgeladen wurde.
• Ordnerstruktur: Erstellt oder verwendet Bereitstellungsordner, um Lösungsdateien im Orchestrator zu organisieren.
• Konfigurationsunterstützung: Unterstützt benutzerdefinierte Konfigurationsdateien für umgebungsspezifische Einstellungen.
• Bereitstellungsverwaltung: Kann neue Bereitstellungen erstellen oder vorhandene basierend auf dem Bereitstellungsnamen aktualisieren.
• 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.
• Umgebungszielauswahl: Bereitstellungsordner ermöglichen das Zielen auf bestimmte Umgebungen (dev, test, prod).

Pipelinebeispiele

Bereitstellung der Basislösung

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

Mit Orchestrator-Verbindung und benutzerdefinierter Konfiguration

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

Vollständige Pipeline: hochladen und bereitstellen

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'