Lösungsbereitstellung mit Pipelines

UiPath® Solution Management ermöglicht die Bereitstellung von Automatisierungen zusammen mit allen erforderlichen Ressourcen. Um dies in den Lebenszyklus der Automatisierungsentwicklung zu integrieren, hat UiPath® Automation Ops™ – Pipelines Unterstützung für die Lösungsbereitstellung hinzugefügt. Jetzt können Sie eine Lösung mit jeder Codeänderung Ihrer Automatisierungen automatisch testen und erneut bereitstellen.

Hinweis:

Um den vollen Nutzen aus dieser Pipeline zu ziehen, müssen Sie mit dem Lösungskonzept im UiPath®-Kontext vertraut sein. Weitere Informationen finden Sie unter Übersicht über die Lösungsverwaltung.

Verwenden der vorgefertigten Pipeline

Sie können eine vorgefertigte Pipeline aus dem UiPath-Marktplatz verwenden. Sie müssen das Marketplace-Paket herunterladen, einen Prozess daraus erstellen und die lösungsspezifischen Rollen zuweisen, wie in den folgenden Schritten beschrieben:

Hinweis:

The Solution project must be set up in advance before you can deploy it using Pipelines.

1. Laden Sie das Paket Lösungsbereitstellungspipeline vom UiPath® Marketplace herunter.

   
   
   
   
   

2. Erstellen Sie einen Pipelineprozess im Laufzeitordner Pipelines im Orchestrator. Um Ihren Pipeline-Runtime-Ordner im Orchestrator zu überprüfen, wechseln Sie zu Pipelines > Runtime-Einstellungen, wie auch im folgenden Beispiel gezeigt:

   
   
   
   
   

3. Weisen Sie dem Pipelines-Roboterkonto die Mandantenrolle Lösungsadministrator zu. Sie müssen diese Rolle in allen Mandanten zuweisen, die die Pipeline für Lösungen verwaltet.

Schritte in der Lösungsbereitstellungspipeline

Die folgende Liste bietet eine Zusammenfassung der Schritte, die am Prozess der Lösungsbereitstellungspipeline beteiligt sind:

1. Klonen des Repositorys.

2. Zeile für Zeile durch die Lösungspipeline-Konfigurationsdatei gehen und für jedes Projekt (jede Zeile) analysieren, Tests ausführen, eine neue Paketversion erstellen, veröffentlichen und den Zielprozess (im Lösungsprojekt angegeben) aktualisieren .

3. Synchronisieren des Lösungsprojekts, damit es über die neuen Versionen der Automatisierungen informiert wird.

4. Veröffentlichen des Lösungspakets in der ersten Umgebung.

5. Herunterladen der Konfigurationsdatei des Lösungspakets.

6. Bereitstellen der Lösung.

7. Aktivieren der Lösung.

8. Wird zur Genehmigung ausgesetzt.

9. Herunterladen des Lösungspakets aus der ersten Umgebung und Hochladen in die zweite Umgebung.

10. Bereitstellen der Lösung in der zweiten Umgebung.

11. Aktivieren der Lösung.

Pipelineargumente

In der folgenden Tabelle werden die verfügbaren Pipelineargumente beschrieben.

Name	Beschreibung
Richtlinie analysieren (optional)	Die Governance-Richtlinie, die die im Pipelineprozess verwendeten Workflow-Analyseregeln enthält. Wenn dies leer gelassen wird, wird die Analyse des Projekts übersprungen.
Orchestrator-URL	Die URL des Orchestrators, auf dem Automatisierungspakete veröffentlicht werden.
Name des Lösungsprojekts	Der Name des Lösungsprojekts. Er wird zur Identifizierung des Lösungsprojekts verwendet.
Name des Lösungspakets	Der Name des Lösungspakets, das erstellt wird.
Version des Lösungspakets	Die Version des Lösungspakets, das erstellt wird.
AppendBuildNumberToSolutionVersion	Ermöglicht das Hinzufügen eines Suffixes mit der Build-Nummer zur Lösungspaketversion. Dies ist nützlich, um Versionskonflikte bei nachfolgenden Pipelineausführungen zu vermeiden. Weitere Informationen zu den Standardargumenten, z. B. Buildnummer, finden Sie unter Standardargumente des Pipelineprozesses.
Beschreibung des Lösungspakets	Die Beschreibung des Lösungspakets.
Lösungsstammordner	Der Stammordner, unter dem alle Lösungskomponenten bereitgestellt werden.
SolutionPipelineConfigurationFile (optional)	Der relative Pfad von der Konfigurationsdatei der Lösungspipeline zum Repository-Stamm (z. B. solution-pipeline-configuration.csv). Wenn sie fehlt, werden die Projekte nicht neu erstellt und das Lösungspaket wird ausschließlich auf der Grundlage der Informationen im Lösungsprojekt neu erstellt.
ErsterMandant	Der Name des Mandanten, unter dem das Lösungsprojekt definiert ist und wo die Lösung zuerst bereitgestellt wird.
ErsterBereitstellungsordner	Der Ordner im ersten Mandanten, in dem die Lösung bereitgestellt wird. Sie ist der übergeordnete Ordner des Lösungsstammordners. Wenn leer, wird die Lösung im Stamm des Mandanten bereitgestellt.
NameDerLösungErstenBereitstellung	Der Name dieser Installation, damit er später darauf zurückgreifen kann. Ein Lösungspaket kann mehrere Bereitstellungen haben.
InZweiterUmgebungBereitstellen	Aktiviert den Rest der Pipeline im Zusammenhang mit der Bereitstellung der Lösung in der zweiten Umgebung.
ZweiterMandant (optional)	Der Mandant, in dem die Lösung zum zweiten Mal bereitgestellt wird. Wenn nicht vorhanden, wird FirstTenant verwendet.
ZweiterBereitstellungsordner (Optional)	Der Ordner im zweiten Mandanten, in dem die Lösung bereitgestellt wird. Sie ist der übergeordnete Ordner des Lösungsstammordners. Wenn leer, wird die Lösung im Stamm des Mandanten bereitgestellt.
NameDerLösungZweiteBereitstellung (Optional)	Der Name der zweiten Installation zum späteren Verweisen. Wenn nicht vorhanden, wird der erste Name der Bereitstellung verwendet.
Testordner	Der Orchestrator-Ordner, in dem die Tests ausgeführt werden. Dies funktioniert zusammen mit dem OrchestratorUrl -Argument.
Überspringen	Deaktiviert/Aktiviert die Durchführung der Tests. Standardmäßig führt die Pipeline die Tests aus.
GenehmigerEMailAdresse	Die E-Mail-Adresse des Benutzers, der die Bereitstellung in der zweiten Umgebung genehmigt, in der Regel nach der Validierung der ersten Bereitstellung. Er wird verwendet, um die Genehmigungsaufgabe im Action Center zuzuweisen.
SupportUserEmailAddress (Optional)	Die E-Mail-Adresse des Benutzers, der bei Bedarf eingreifen und Lösungsbereitstellungsfehler beheben kann. Wenn sie nicht vorhanden ist, wird die Pipeline bei Fehlern bei der Lösungsbereitstellung unterbrochen. Hinweis: Die vorgefertigte Pipeline ist generisch. Es konnte keine Logik enthalten, um die obligatorische Bereitstellungskonfiguration jeder spezifischen Lösung abzudecken. Aus diesem Grund wird die Pipeline angehalten, wenn die Bereitstellung fehlschlägt, und fragt nach einer manuellen Fehlerbehebung. Um dies zu vermeiden, können Sie die Konfigurationsdatei des Lösungspakets in Ihrer benutzerdefinierten Pipeline verwenden.
Synchronisierung überspringen (optional)	Sie kann verwendet werden, um ein Lösungspaket ohne Aktualisierungen neu zu erstellen.
ÜberspringenValidierung (optional)	Überspringt die Validierung während des Projekterstellungsschritts.

Behandeln von Bereitstellungsproblemen

Im Falle einer fehlgeschlagenen Bereitstellung wird eine Aktionsaufgabe für die Unterstützung erstellt und die Pipeline wird angehalten, sodass sie repariert werden kann. Sobald die Bereitstellung behoben ist, muss die Aktionsaufgabe abgeschlossen werden, um die Pipelineausführung fortzusetzen.

Warten Sie bei der Korrektur einer Bereitstellung, bis die Bereitstellung den Status „Erfolgreich“ erreicht hat, bevor Sie die Aufgabe abschließen.

Um ein Bereitstellungsproblem manuell zu beheben, wechseln Sie zu Lösungsverwaltung > Bereitstellungen, identifizieren Sie die Bereitstellung und wählen Sie Bereitstellungsassistent fortsetzen aus, wie auch im folgenden Beispiel gezeigt:

Erstellen einer benutzerdefinierten Pipeline aus der Vorlage

Der Prozess der Lösungsbereitstellungspipeline ist vorgefertigt, um die meisten Anwendungsfälle abzudecken. Sie können sie jedoch an Ihre Anforderungen anpassen. Dazu müssen Sie die Vorlage aus Studio abrufen und anpassen. Weitere Informationen zu Vorlagen in Studio finden Sie unter Über das Aktivitätspaket Pipelines.

Hinweis:

Stellen Sie sicher, dass in Studio > Vorlagen die Option Vorabversion einschließen aktiviert ist.

Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Pipeline zu erstellen:

1. Erstellen Sie Ihr Lösungsprojekt in der Lösungsverwaltung.

   
   
   
   
   

2. Bewahren Sie Ihre Automatisierungsprojekte unter Source Control in GitHub- oder Azure-Repositorys auf. Der gesamte Projektcode Ihrer Lösung muss im selben Git-Repository gespeichert werden.

   
   
   
   
   

3. Fügen Sie eine neue Konfigurationsdatei (weitere Informationen finden Sie unter Konfigurationsdatei der Lösungspipeline) zu Ihrem Repository hinzu, die die Zuordnung zwischen der Automatisierung, die im Lösungsprojekt in Schritt 1 verwendet wird, und den jeweiligen Projektpfaden im Repository beibehält. Das folgende Beispiel zeigt eine Lösungspipeline-Konfigurationsdatei:

   
   
   
   
   

4. Weisen Sie dem Pipelines-Roboterkonto die Mandantenrolle Lösungsadministrator zu. Sie müssen diese Rolle in allen Mandanten zuweisen, die die Pipeline für Lösungen verwaltet. Das Roboterkonto Pipelines ist das Roboterkonto, das zum Ausführen der Pipelines verwendet wird, und ist Ihrem Ordner Pipelines im Orchestrator zugewiesen.

   
   
   
   
   

   Weitere Informationen zu Pipelines-Roboterkontorollen finden Sie unter Ersteinrichtung.

   Sie finden Ihren Pipelines-Ordner im Orchestrator, indem Sie die Runtime-Einstellungen unter Pipelines überprüfen.

   
   
   
   
   

5. Erstellen Sie eine Pipeline in Automation Ops. Um die Pipeline auszulösen, wenn eine Änderung im gesamten Repository auftritt (ein Projekt der Lösung ändert sich), wählen Sie nur das Repository und nicht auch das Projekt im ersten Schritt der Pipelinedefinition aus.

   
   
   
   
   

6. Legen Sie die Pipelineargumente fest und starten Sie Ihre Pipeline.

   
   
   
   
   

Konfigurationsdatei der Lösungspipeline

Die Konfigurationsdatei der Lösungspipeline ordnet die in der Lösung verwendeten Automatisierungen ihren Quellcodeprojekten zu. Die Pipeline benötigt eine solche Zuordnung, um zu wissen, welche Projekte erstellt werden sollen und wo sie platziert werden sollen, um die Lösung zu aktualisieren. Dieses Format ist nur ein Vorschlag, der von der vorgefertigten Pipeline verwendet wird. Sie können Ihr eigenes Format verwenden, wenn Sie Ihren benutzerdefinierten Pipelineprozess erstellen.

Die Konfiguration der Lösungspipeline ist eine .csv -Datei mit dem folgenden Format:

PathToProjectJson,PackageName,OrchestratorFolder,ProcessName,RunTests

Wichtig:

Die erste Zeile ist der Header der .csv -Datei und erforderlich.

Jede der Zeilen konfiguriert die Aktionen, die für ein Projekt ausgeführt werden, wie in der folgenden Tabelle beschrieben:

Name	Beschreibung
PfadZuProjektJSON	Der relative Pfad zu project.json vom Stamm des Repositorys.
PackageName	Der Name des Pakets, das aus dem Projekt erstellt wurde.
Orchestrator-Ordner	Der Ort, an dem der Prozess in Orchestrator aktualisiert wird.
ProcessName	Der Name des zu aktualisierenden Prozesses.
Tests ausführen	Ob Tests als Teil der Pipeline ausgeführt werden sollen oder nicht.

Im Folgenden finden Sie ein Beispiel für eine Konfigurationsdatei:

PathToProjectJson,PackageName,OrchestratorFolder,ProcessName,RunTests
Blank Process 16/project.json,Blank.Process.16,Finance,Blank.Process.16,True
ComputeSLA/project.json,ComputeSLA,Finance,ComputeSLA,False

Konfigurationsdatei des Lösungspakets

Die Konfigurationsdatei des Lösungspakets ist die Datei, mit der die Konfiguration der automatisierten Bereitstellung der Lösung gesteuert wird.

Wichtig:

Die Konfigurationsdatei der Lösungspipeline unterscheidet sich von der Konfigurationsdatei des Lösungspakets. Die Konfiguration der Lösungspipeline behält die Zuordnung zwischen der Lösung und dem Projekt bei. In der Konfiguration des Lösungspakets wird die Konfiguration der Lösungskomponenten für die Bereitstellung gespeichert.

Ein typischer Anwendungsfall dafür ist das Festlegen der Kennwörter in Anmeldeinformationsassets, die in der Lösung verwendet werden.

Kennwörter von Anmeldeinformationsassets, die Teil Ihrer Lösung sind, werden nicht im Lösungspaket gespeichert und müssen während der Bereitstellung angegeben werden.

Um das Kennwort als Teil der Pipeline festzulegen, müssen Sie die Konfigurationsdatei des Lösungspakets herunterladen und entsprechend aktualisieren.