Backstage Scaffolder 2026: Vom Template zur Self-Service-Plattform

📷 "Charity Fashion Show Backstage" by lanier67 is licensed under CC BY-NC-ND 2.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-nc-nd/2.0/.

Der Backstage Scaffolder ist das Herzstück eines jeden Developer Portals: Er ermöglicht Entwicklerteams, neue Projekte, Services und Komponenten per Self-Service anzulegen – ohne auf ein Plattform-Team warten zu müssen. Mit dem Release von Backstage 1.55 im Oktober 2026 und der zunehmenden Reife des v1beta3-Formats hat der Scaffolder einen Sprung nach vorne gemacht, der ihn von einem praktischen Tool zur strategischen Plattform-Komponente werden lässt.

Vom Template zum Golden Path

Die Idee hinter dem Scaffolder ist einfach: Statt dass jedes Team seine CI/CD-Pipeline, Repository-Struktur und Kubernetes-Manifeste von Hand aufsetzt, definiert das Plattform-Team einmalige Software Templates – codierte Vorlagen, die nach einem standardisierten Workflow durchlaufen werden. Entwickler wählen im Backstage-Frontend ein Template aus, füllen ein Formular aus, und der Scaffolder erledigt den Rest: Repository anlegen, Code-Grundgerüst generieren, CI/CD konfigurieren, im Catalog registrieren.

Mit dem v1beta3-Format hat Backstage die Template-Definition grundlegend überarbeitet. Anders als in früheren Versionen sind Templates nun klarer strukturiert: parameters definieren die Eingabemaske, steps die auszuführenden Aktionen und output die Rückgabewerte für das Frontend. Die Schritte werden sequenziell abgearbeitet und können aufeinander aufbauen – etwa wenn ein publish:github-Schritt die Repository-URL an den folgenden catalog:register-Schritt übergibt.

Ein Template kann beliebig viele Schritte umfassen: Code aus einem Git-Template klonen, Variablen ersetzen, Secrets injizieren, Terraform ausführen, eine Datenbank provisionieren und das fertige Produkt im Backstage-Catalog sichtbar machen. Was früher stundenlange manuelle Arbeit bedeutete, wird so zu einem wenige Sekunden dauernden Self-Service-Vorgang.

Custom Actions: Die Macht der Erweiterbarkeit

Neben den mitgelieferten Aktionen (etwa fetch:template, publish:github, debug:log) können Plattform-Teams eigene Custom Actions schreiben. Diese werden als Node.js-Paket implementiert und in den Scaffolder eingebunden. Dadurch lässt sich praktisch jeder interne Prozess automatisieren: die Erstellung eines Jira-Tickets, die Provisionierung einer Cloud-Ressource oder die Generierung eines Zertifikats.

Die Roadie-Community listet inzwischen über 50 verfügbare Scaffolder-Aktionen – von der Interaktion mit Cloud-Anbietern bis zur Integration mit Monitoring-Tools. Backstage selbst liefert seit Version 1.54 die scaffolder.requireScmUserCredentials-Option, die für bestimmte Aktionen zwingend Benutzeranmeldedaten verlangt – ein wichtiger Schritt in Richtung Governance.

Task Recovery: Endlich robuste Automatisierung

Ein langjähriger Kritikpunkt am Scaffolder war die mangelnde Fehlertoleranz: Stürzte der Prozess während der Ausführung ab, musste das gesamte Template von vorne durchlaufen werden. Ein GitHub-Issue aus April 2025 brachte es auf den Punkt: „Es ist nicht nur unbequem, sondern technisch problematisch, den gesamten Scaffolder-Prozess neu starten zu müssen."

Backstage 1.55, veröffentlicht am 13. Oktober 2026, behebt dieses Problem mit der neuen Task Recovery-Funktion. Ist sie aktiviert, kann ein unterbrochener Task ab dem letzten erfolgreich abgeschlossenen Schritt fortgesetzt werden. Die Schritt-Ergebnisse bleiben persistent, und Task-Secrets werden erst gelöscht, wenn der Task einen Endzustand erreicht hat. Die Konfiguration erfolgt über den neuen Abschnitt scaffolder.taskRecovery in der Backstage-Konfiguration.

Die Dokumentation weist jedoch auf eine wichtige Einschränkung hin: Aktionen in wiederaufgenommenen Tasks sollten idempotent sein oder Checkpoints verwenden, da ein Schritt potenziell ein zweites Mal ausgeführt werden kann. Für Produktionsumgebungen empfiehlt das Backstage-Team zudem ein externes Storage-Backend – etwa das GCP-Modul – statt der integrierten Datenbank, die auf 50 MB begrenzt ist.

Performance-Sprung durch kluge Optimierungen

Neben der Task Recovery zeigt Backstage 1.55, dass auch scheinbar kleine Änderungen große Wirkung entfalten können. Michael Todorovic, Senior SRE bei Veepee, optimierte die GitLab-Merge-Request- und Push-Aktionen: Statt für jede Datei eine separate API-Anfrage an GitLab zu stellen, vergleicht der Code die Dateien nun lokal. Die Zahl der API-Requests sank von rund 300 auf unter zehn, die Ausführungszeit von 5–15 Sekunden auf etwa drei Sekunden.

Solche Optimierungen mögen unspektakulär klingen, sind aber im täglichen Betrieb eines Developer Portals mit Hunderten von Template-Ausführungen ein entscheidender Faktor für die Akzeptanz im Entwicklerteam.

Fazit

Der Backstage Scaffolder hat sich von einer einfachen Template-Engine zu einer ausgewachsenen Automatisierungsplattform entwickelt. Mit dem v1beta3-Format, der Task Recovery in 1.55 und der wachsenden Zahl an Custom Actions deckt er heute die Bedürfnisse von Plattform-Teams ab, die Developer Experience und Governance gleichermaßen ernst nehmen. Wer ein Internal Developer Portal betreibt, sollte den Scaffolder nicht nur als „Nice-to-have" betrachten, sondern als strategisches Werkzeug, das die Produktivität eines gesamten Engineering-Teams skaliert.