Woodpecker CI: Pipelines bewusst betreiben
Ein Testlauf nach jedem Commit spart Handarbeit, aber eine Pipeline ist nicht automatisch ein verlässliches Freigabesignal. Woodpecker CI beschreibt Workflows aus Schritten, mit denen Code gebaut, getestet und bereitgestellt werden kann. Die Schritte laufen standardmäßig nacheinander; liefert einer einen Fehlerstatus, wird der Workflow beendet. Das macht die Reihenfolge selbst zum Teil der Qualitätssicherung. Ein Deployment-Schritt gehört daher nicht vor einen Test, dessen Fehlschlag es verhindern soll. Diese Grundregel folgt direkt aus der dokumentierten Workflow-Semantik. [1]
Schritte als kontrollierte Ausführungsumgebung
Nach der Woodpecker-Dokumentation führt jeder Schritt Befehle in einem festgelegten Container aus. Der zugehörige Commit wird in einen Arbeitsbereich ausgecheckt, der den Schritten zur Verfügung steht. Standardmäßig ist die Ausführung seriell; für eine andere Abhängigkeitsstruktur gibt es depends_on. Für einen ersten Workflow genügt deshalb eine überprüfbare Reihenfolge aus Build und Test. Parallelität ist erst dann sinnvoll, wenn unabhängig ausführbare Arbeiten identifiziert sind. Sonst erschwert sie nur die Diagnose eines fehlgeschlagenen Laufs. [1]
Notiere, welche Container-Images die Schritte verwenden und welche Ausgaben sie hinterlassen. Ein erfolgreiches Testergebnis sagt nichts darüber aus, ob ein späterer Schritt ein falsches Ziel anspricht oder ein Image unbemerkt gewechselt hat. Für die Herkunft von Images und die Grenzen zusätzlicher Metadaten behandelt der Beitrag zu Container-Signaturen und SBOMs einen anderen Teil derselben Lieferkette. Woodpecker ersetzt diese Prüfung nicht; es führt nur die definierten Schritte aus.
Secrets dürfen nicht mit dem Code reisen
Woodpecker kann benannte Geheimnisse zentral speichern und mit from_secret einzelnen Pipeline-Schritten übergeben. Die offizielle Dokumentation unterscheidet Repository-, Organisations- und globale Secrets. Ein globales Secret ist für Pipelines der gesamten Instanz verfügbar und sollte deshalb zurückhaltend eingesetzt werden. Besonders wichtig: Secrets sind standardmäßig nicht für Pull-Request-Ereignisse freigegeben. Wer diese Grenze für ein öffentliches Repository aufhebt, kann fremdem Code einen Weg zu sensiblen Daten eröffnen. [2]
Der Secret-Store löst nicht jedes Problem. Woodpecker warnt ausdrücklich, dass es externe Secrets nicht auf dieselbe Weise in Logs maskieren kann wie Werte aus seinem eigenen Store. Prüfe deshalb, welche Jobs Zugang zu welchen Schlüsseln erhalten und ob die Protokolle nur die benötigten Informationen zeigen. Ein Testjob braucht keinen Produktionsschlüssel; ein Veröffentlichungsschritt braucht wiederum nicht alle Verwaltungsrechte des Git-Servers. Solche Trennungen müssen in der konkreten Pipeline und den angeschlossenen Diensten vorgenommen werden, nicht durch einen allgemeinen „CI ist sicher“-Schalter. [2]
Ein prüfbarer Weg zum ersten Lauf
Wähle ein unkritisches Repository und ändere eine kleine Datei. Kontrolliere, ob der Lauf den beabsichtigten Commit auscheckt, Build und Test in der erwarteten Folge ausführt und ein absichtlich fehlschlagender Test die weiteren Schritte tatsächlich stoppt. Prüfe anschließend, dass ein Pull Request keinen vertraulichen Deploy-Schlüssel erhält. Erst danach sollte eine Bereitstellung hinzugefügt werden. Für wiederholbare Dienste ist die Trennung zwischen Anwendungskonfiguration und Laufzeitdaten ebenfalls wichtig; der Artikel zu Docker-Compose-Betrieb bietet dafür zusätzlichen Kontext.
Der Nutzen liegt in reproduzierbaren Prüfungen, deren Fehler unmittelbar sichtbar werden. Die Grenze ist die Vertrauensstellung des Agents: Er führt Projektcode und Images aus und muss deshalb mit angemessen isoliertem Zugriff betrieben werden. Eine grüne Pipeline beweist nur, dass ihre definierten Kontrollen bestanden wurden. Sie beweist weder die Sicherheit jeder Abhängigkeit noch eine erfolgreiche Wiederherstellung des Zielsystems. Halte den ersten Workflow klein, nachvollziehbar und ohne ungenutzte Berechtigungen. Schreibe nach jedem fehlgeschlagenen Test auf, ob die Ursache im Projektcode, im verwendeten Image oder in den Rechten des Agents lag.
Für den ersten Deploy-Schritt gehört eine eigene Freigabegrenze in den Workflow: Tests dürfen auf Beiträgen aus nicht vertrauenswürdigen Branches laufen, ein Produktionsschlüssel dagegen nicht automatisch an jeden solchen Lauf gelangen. Prüfe mit einem Test-Commit und einer bewusst fehlschlagenden Stufe, ob der Deploy-Schritt tatsächlich ausbleibt. Notiere, ob Geheimnisse aus dem internen Woodpecker-Store oder externen Quellen stammen; laut Dokumentation lassen sich externe Werte nicht im gleichen Maß in Logs maskieren. Die Agent-Rechte sollten deshalb unabhängig vom YAML auf das notwendige Ziel begrenzt bleiben. [1] [2]

