Pipelines

Pipelines führt lokale, nachvollziehbare Projekt-Pipelines: eine Laufhistorie, mitgeschriebene Protokolle und eine abgesicherte Ausführung. Gedacht ist das Paket für Projektbeteiligte, die Läufe und Protokolle nachlesen, und für Verwalter, die Ausführende bereitstellen und den Zugriff festlegen.

Auf dieser Installation sind keine Ausführenden eingerichtet. Läufe und Protokolle lassen sich ansehen, ausgelöst wird nichts — siehe Auf dieser Installation fehlen die Ausführenden.

Erste Schritte

Schnelleinstieg: Die erste Pipeline starten und ihr Protokoll lesen — der kürzeste Weg zum ersten Ergebnis, in drei Schritten.

Voraussetzungen prüfen → Zugriff klären → Protokolle lesen

Häufige Aufgaben

Was Sie wollen	Für wen	Wo Sie das tun	Anleitung
die Laufhistorie ansehen	Projektbeteiligte	Projektseite, Nabe „Pipelines„	Zweck
ein Protokoll lesen	Projektbeteiligte	Lauf öffnen	Drei Protokollströme
verstehen, warum sich nichts auslösen lässt	alle	–	Fehlende Ausführende
festlegen, wer ausführen darf	Verwaltung	Konfigurationsmanager	Ansehen und Ausführen
eine Einstellung ändern	Verwaltung	Konfigurationsmanager	Konfiguration
wissen, was das Paket nicht leistet	alle	–	Grenzen

Zweck

Lokale, nachvollziehbare Projekt-Pipelines: eine Laufhistorie, mitgeschriebene Protokolle und eine Ausführung hinter einem Recht, das absichtlich strenger ist als das zum Ansehen.

Pipelines laufen lokal, über getrennte Aktions- und Shell-Ausführungs-Plugins, mit dem Projekt — und wahlweise einem Repository, Arbeitselement oder Fix — als gebundenem Kontext. Der erste tatsächliche Anwendungsfall ist das Bauen von Installationspaketen.

Dies ist kein Ersatz für Azure DevOps Pipelines und soll keiner werden. Es führt keine unkontrollierte Shell aus, und es führt keinen langlaufenden Auftrag innerhalb einer HTTP-Anfrage aus.

Auf dieser Installation fehlen die Ausführenden

Nachgemessen: keines der beiden Ausführungs-Plugins ist hier vorhanden. Läufe haben deshalb auf dieser Installation nichts auszuführen; benutzbar bleiben die Bereiche zum Durchsehen und die Historie.

Das ist eine Aussage über diese Installation, kein Mangel des Plugins.

Drei Protokollströme, die nicht zusammengelegt werden

Strom	Inhalt
`out`	Standardausgabe des Prozesses
`err`	Standardfehlerausgabe des Prozesses
`sys`	der Bericht des Ausführenden selbst über den Versuch

Der dritte Strom beantwortet die erste Frage nach jedem Fehlschlag: ist der Prozess gescheitert, oder ist er nie gestartet?

Die Ströme dürfen nicht zusammengelegt werden. Ein zusammengelegtes Protokoll liest sich bequemer und zerstört genau die eine Unterscheidung, auf die es nach einem Fehlschlag am meisten ankommt. Kommentare des Ausführenden nach out zu schreiben sieht harmlos aus und hat dieselbe Wirkung.

Ansehen und Ausführen sind zwei Fragen

Recht	Fragt
`canView`	nach der Projektrolle
`canRun`	nach dem weiteren Berechtigungskontext

Ausführen ist keine Rollenprüfung. Eine Projektrolle verleiht für sich genommen nicht die Fähigkeit, auf dem Server einen Prozess zu starten. Deshalb sind es zwei Fragen und nicht eine.

Jeder Lauf trägt einen Handelnden, sodass die Ausführung zurechenbar bleibt.

Konfiguration

Keine. Pipelines werden je Projekt festgelegt, die Rechte kommen aus Rolle und Berechtigungskontext, die Historie aus der Ablage.

Voraussetzungen

PHP 8.2 oder neuer.
Core Plugin, DevOps Core, DevOps Storage Plugin.
Die Aktions- und Shell-Ausführungs-Plugins, die die eigentliche Ausführung leisten — auf dieser Installation nicht vorhanden, siehe oben.

Grenzen

Kein Ersatz für Azure DevOps Pipelines, und nicht dazu bestimmt, einer zu werden.
Eine interaktive Pipeline wird nie fertig. Aus einer Wiki-Anfrage heraus gestartet, gibt es niemanden, der eine Rückfrage beantwortet. Pipelines müssen durchgehend nicht-interaktiv sein — keine Bestätigungen, keine seitenweise Ausgabe.
Ohne die Ausführungs-Plugins gibt es nichts auszuführen, was dem gegenwärtigen Stand dieser Installation entspricht.

Paketangaben

Plugin: wkdopipelines
Namespace: lib/plugins/wkdopipelines/
Autor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Lizenz: GPL 2