Erstellen und Verwenden gemeinsam genutzter Pipelines in Code Stream

Als Code Stream-Administrator können Sie Pipelines freigeben, damit Benutzer in einer Organisation sie in einem anderen Projekt ausführen oder als verschachtelte Aufgaben innerhalb einer Pipeline zu einem anderen Projekt hinzufügen können.

Vorteile einer gemeinsam genutzten Pipeline

Bei gemeinsamer Nutzung einer Pipeline entfällt die Notwendigkeit, dieselbe Pipeline für verschiedene Projekte innerhalb einer Organisation zu erstellen. Darüber hinaus erhalten alle Pipeline-Benutzer bei einem Update der gemeinsam genutzten Pipeline dasselbe Update.

Eine gemeinsam genutzte Pipeline kann auch in Service Broker verwendet werden. Ein Service Broker-Administrator kann die gemeinsam genutzte Pipeline als Katalogelement hinzufügen, das von Benutzern angefordert und in mehreren Projekten ausgeführt werden kann.

Nur Code Stream-Administratoren können Pipelines gemeinsam nutzen oder die gemeinsame Nutzung beenden.

Vorgehensweise zur gemeinsam Nutzung einer Pipeline

Klicken Sie für die gemeinsame Nutzung einer Pipeline auf Pipeline und wählen Sie die Pipeline aus, die gemeinsam genutzt werden soll.

1. Klicken Sie auf Aktionen > Für Projekte freigeben
2. Wenn die Pipeline deaktiviert wurde, klicken Sie auf Aktionen > Aktivieren.
3. (Optional) Klicken Sie zum Bereitstellen der gemeinsam genutzten Pipeline in Service Broker auf Aktionen > Freigeben.

   Nach der Freigabe der Pipeline kann sie von einem Service Broker-Administrator zu Service Broker hinzugefügt werden. Weitere Informationen finden Sie unter Hinzufügen von Code Stream-Pipelines zum Service Broker-Katalog.

Vorgehensweise zum Ausführen einer gemeinsam genutzten Pipeline

Zum Ausführen einer gemeinsam genutzten Pipeline wählen Sie die Pipeline und ein Projekt aus.

Die Pipeline wird im Kontext des von Ihnen ausgewählten Projekts ausgeführt und nur das Pipeline-Modell wird freigegeben. Die Infrastruktur, wie z. B. in der Pipeline verwendete Endpoints oder Variablen, wird nicht gemeinsam genutzt. Wenn eine gemeinsam genutzte Pipeline, die Endpoints oder Variablen verwendet, in einem anderen Projekt ausgeführt wird, müssen diese Endpoints und Variablen im entsprechenden Projekt verfügbar sein.

Beispiel: jenkinsPipeline verwendet projectA und integriert eine Aufgabe mit einem Endpoint namens jenkinsEndpoint.

Wenn Sie die jenkinsPipeline gemeinsam nutzen und zusammen mit projectB ausführen möchten, muss ein jenkinsEndpoint in projectB vorhanden sein. Wenn kein jenkinsEndpoint vorhanden ist, erstellen Sie den Endpoint in projectB, bevor Sie die gemeinsam genutzte Pipeline ausführen.

Das folgende Verfahren zeigt, wie Sie einen Endpoint in einem anderen Projekt duplizieren. Sie führen ähnliche Schritte für eine Variable aus.

1. Klicken Sie auf Endpoints. Klicken Sie auf dem zu duplizierenden Endpoint, z. B. jenkinsEndpoint, auf Aktionen > Exportieren.
2. Klicken Sie auf die Schaltfläche Importieren und wählen Sie die YAML-Datei für jenkinsEndpoint aus.
3. Bearbeiten Sie die Datei zum Ändern des Projekts, z. B. projectB im folgenden YAML-Beispielcode.

   ---
   project: projectB
   kind: ENDPOINT
   name: jenkinsEndpoint
   ...

4. Klicken Sie auf Importieren.

Klicken Sie zum Ausführen von jenkinsPipeline in projectB auf Ausführen auf der Karte der Pipeline und wählen Sie projectB als Projekt aus.

Hinweis: Zum Ausführen der gemeinsam genutzten Pipeline in projectB müssen Sie über die Code Stream-Rolle „Administrator“, „Entwickler“ oder „Executor“ verfügen. Als Code Stream-Betrachter oder -Benutzer können Sie die Pipeline nicht ausführen, es sei denn, ein Code Stream-Administrator macht Sie zum Projektadministrator oder Projektmitglied in projectB. Weitere Informationen zu Rollen in Code Stream finden Sie unter Vorgehensweise zum Verwalten des Benutzerzugriffs und der Genehmigungen in Code Stream.

Vorgehensweise zum Hinzufügen einer gemeinsam genutzten Pipeline zu einer anderen Pipeline

Wenn Sie gemeinsam genutzte Pipelines als verschachtelte Aufgaben in einer anderen Pipeline verwenden, können Sie die Pipeline-Funktion über die in einem Projekt enthaltenen Pipelines hinaus ausdehnen. Die gemeinsam genutzten Pipelines können sich in unterschiedlichen Projekten und in der Pipeline befinden, in der sie als verschachtelte Aufgaben enthalten sind.

Das folgende Beispiel zeigt eine Pipeline mit dem Namen master-shared-pipeline-demo und zwei verschachtelten Pipeline-Aufgaben.

Zur Angabe der Pipeline für Task0 wählen Sie sie aus einer Liste gemeinsam genutzter Pipelines aus. Jeder Pipeline-Name enthält den Projektnamen. Wenn mehrere gemeinsam genutzte Pipelines denselben Namen aufweisen, können Sie den Projektnamen zur Auswahl der gewünschten Pipeline verwenden.

Hinweis: Zur Ausführung einer Pipeline mit verschachtelten Pipelines muss die Pipeline auf alle Endpoints oder Variablen zugreifen können, die in den verschachtelten Pipelines verwendet werden. Wenn dies nicht möglich ist, müssen Sie den Inhalt im Projekt für die Pipeline erstellen.

Vorgehensweise zum Verwenden einer gemeinsam genutzten Pipeline für Rollback

Wählen Sie zur Verwendung einer gemeinsam genutzten Pipeline für Rollback diese in einer Liste mit Pipelines aus, wenn Sie ein Rollback für die Aufgabe konfigurieren. Code Stream filtert die Liste so, dass nur Pipelines für dasselbe Projekt oder gemeinsam genutzte Pipelines in unterschiedlichen Projekten angezeigt werden.

Vorgehensweise zum Verwenden einer gemeinsam genutzten VMware Cloud-Vorlage in einer Pipeline

Sie können eine gemeinsam genutzte VMware Cloud-Vorlage als Cloud-Vorlagenquelle für eine Aufgabe in einer Pipeline verwenden. Bei Verwendung gemeinsam genutzter Cloud-Vorlagen stehen mehr Cloud-Vorlagen zur Verfügung, als in einem Projekt enthalten sind.

Stellen Sie vor dem Definieren der Aufgabe in Code Stream sicher, dass die Cloud-Vorlage in Cloud Assembly freigegeben ist und Sie den Namen und die Version kennen. Bei der Freigabe einer Cloud-Vorlage wird in der Liste der Cloud-Vorlagen neben dem Projektnamen ein Symbol angezeigt.

So verwenden Sie eine VMware Cloud-Vorlage in Ihrer gemeinsam genutzten Pipeline:

• Wählen Sie VMware Cloud-Vorlage als Aufgabentyp aus.
• Wählen Sie unter „Aktion“ die Option Bereitstellung erstellen oder Bereitstellung aktualisieren aus.
• Wenn Sie eine Bereitstellung aktualisieren, wählen Sie den Namen der Bereitstellung aus.
• Wählen Sie VMware Cloud-Vorlage als Quelle der Cloud-Vorlage aus.
• Den Namen einer Cloud-Vorlage wählen Sie entweder in der Liste der Cloud-Vorlagen aus oder geben ihn ein. Die Cloud-Vorlage wird unter Umständen nicht aufgeführt, weil sich die Cloud-Vorlage in einem anderen Projekt als die Pipeline befindet und in Code Stream nur Cloud-Vorlagen aufgelistet werden, die sich im selben Projekt befinden.
• Geben Sie für die Cloud-Vorlagenversion die Version der Cloud-Vorlage ein.

Im folgenden Beispiel handelt es sich bei shared-bp um die gemeinsam genutzte VMware Cloud-Vorlage, die Sie in Cloud Assembly überprüft haben und verwenden möchten. Da diese Vorlage aber nicht ausgewählt werden kann, geben Sie ihren Namen ein.

Hinweis: Wenn die von Ihnen angegebene VMware Cloud-Vorlage nicht freigegeben ist und Sie sie in einer Pipeline in einem anderen Projekt verwenden, schlägt die Ausführung der Pipeline mit einer Meldung mit dem Hinweis fehl, dass die ausgewählte Cloud-Vorlage nicht freigegeben ist.

Vorgehensweise zum Löschen oder Beenden der gemeinsamen Nutzung einer Pipeline

Wenn Sie eine gemeinsam genutzte Pipeline als verschachtelte Aufgabe oder für ein Rollback einer Aufgabe hinzufügen, wird auf diese Pipeline über die Pipeline verwiesen, in der sie verwendet wird. Wenn Sie die Pipeline löschen oder die gemeinsame Nutzung der Pipeline beenden möchten, müssen Sie sie aus jeder Pipeline entfernen, die auf sie verweist.

Beispiel: Wenn master-shared-pipeline-demo als verschachtelte Aufgabe Shared-Pipeline enthält, wird auf Shared-Pipeline verwiesen. Sie können die gemeinsame Nutzung von Shared-Pipeline erst löschen oder beenden, wenn Sie sie aus master-shared-pipeline-demo entfernt haben.

Wenn TestRollback Shared-Pipeline verwendet, um ein Rollback einer Aufgabe durchzuführen, wird auf Shared-Pipeline verwiesen. Sie können die gemeinsame Nutzung der Shared-Pipeline erst löschen oder beenden, nachdem Sie sie aus dem Rollback für die Aufgabe in TestRollback entfernt haben.

In folgendem Verfahren wird gezeigt, wie Sie die Verweise einer Pipeline überprüfen und die Pipeline aus der Pipeline entfernen, die auf sie verweist, bevor Sie sie löschen oder die gemeinsame Nutzung beenden.

1. Führen Sie eine Überprüfung auf Verweise durch und aktualisieren Sie die Pipeline-Verweise gegebenenfalls.
   1. Klicken Sie auf Pipelines. Klicken Sie in der gemeinsam genutzten Pipeline, die überprüft werden soll, auf Aktionen > Verweise anzeigen.
   2. Notieren Sie sich die Namen aller Pipelines unter Referenzierte Pipelines.
   3. Öffnen Sie die Pipelines, die auf die gemeinsam genutzte Pipeline verweisen. Entfernen Sie die gemeinsam genutzte Pipeline, die als verschachtelte Aufgabe oder zum Durchführen eines Rollbacks einer Aufgabe verwendet wird, und speichern Sie die Pipeline.
2. Löschen Sie eine Pipeline oder beenden Sie die gemeinsame Nutzung einer Pipeline.
   • Klicken Sie in der zu löschenden Pipeline auf Aktionen > Löschen.
   • Klicken Sie in der Pipeline, deren gemeinsame Nutzung beendet werden soll, auf Aktionen > Gemeinsame Nutzung beenden.