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.

Überprüfen Sie vor dem Ausführen einer gemeinsam genutzten Pipeline, ob die Pipeline Inhalt umfasst, der für die Ausführung der Pipeline in einem anderen Projekt benötigt wird.

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.

Wählen Sie beim Erstellen einer Pipeline mit verschachtelten gemeinsam genutzten Pipelines die gemeinsam genutzte Pipeline aus. Wenn zwei Pipelines mit demselben Namen vorhanden sind, verwenden Sie den Projektnamen zur Auswahl der gewünschten Pipeline.

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 Löschen oder Beenden der gemeinsamen Nutzung einer Pipeline

Wenn Sie eine gemeinsam genutzte Pipeline als verschachtelte Aufgabe hinzufügen, wird auf diese Pipeline von der Pipeline verwiesen, in der sie verschachtelt ist. 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.

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. Öffnen Sie die Pipelines, die auf die gemeinsam genutzte Pipeline verweisen, entfernen Sie die verschachtelte Aufgabe 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.