Wie viel Zeit verbringen Ihre Entwickler damit herauszufinden, wem welcher Microservice gehört? Wo ist die Dokumentation? Wie wird er deployt? Was sind seine Abhängigkeiten? Backstage von Spotify — mittlerweile ein CNCF-Incubating-Projekt — löst genau dieses Problem. Ein zentraler Ort für das gesamte Software-Ökosystem Ihrer Organisation.
Was ist Backstage¶
Backstage ist eine Open-Source-Plattform zum Aufbau von Developer Portalen. Spotify hat es intern für seine über 2.000 Ingenieure entwickelt und 2020 als Open Source veröffentlicht. Im Jahr 2023 ist es ein CNCF-Incubating-Projekt mit einer riesigen Community — über 100 Plugins, im Einsatz bei Spotify, Netflix, American Airlines, HP, IKEA und Dutzenden weiterer Unternehmen.
Der Kern basiert auf drei Säulen: Software Catalog (ein Register aller Services, Bibliotheken, Pipelines und Infrastruktur), Software Templates (Golden Paths zur Erstellung neuer Projekte) und TechDocs (Dokumentation als Code, direkt im Repository).
Software Catalog — Schluss mit „Wem gehört das?”¶
Jeder Service, jede Bibliothek, API, Datenbank, Pipeline — alles ist eine Entität im Katalog. Definiert durch eine YAML-Datei direkt im Repository:
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
name: payment-service
description: Payment microservice
tags: [java, spring-boot, payments]
spec:
type: service
lifecycle: production
owner: team-payments
dependsOn: [component:user-service]
Das Ergebnis: Öffnen Sie Backstage, finden Sie payment-service, sehen Sie den Eigentümer (team-payments), den Status (production), die Abhängigkeiten, wo er läuft, seine APIs und wie er deployt wird. Keine Slack-Nachrichten mehr mit der Frage „Hey, wem gehört der Payment Service?”
Software Templates — Golden Paths¶
Ein neuer Entwickler muss einen Microservice erstellen. Ohne Backstage: Er klont ein bestehendes Projekt, löscht was er nicht braucht, vergisst CI/CD und konfiguriert das Monitoring falsch. Mit Backstage: Er klickt „Create”, wählt das Template „Java Spring Boot Service”, gibt Name und Beschreibung ein — und erhält ein vollständiges Repository mit CI/CD-Pipeline, Dockerfile, Helm Chart, Monitoring-Dashboard und Katalogregistrierung.
Templates werden als Code definiert (Nunjucks + YAML). So kann die Organisation Best Practices kodifizieren — jedes neue Projekt startet richtig. Das ist die Essenz von Platform Engineering: Golden Paths, keine Vorschriften.
TechDocs — Dokumentation, die lebt¶
Backstage integriert einen Docs-as-Code-Ansatz. Markdown-Dateien im Repository werden automatisch gebaut (MkDocs) und direkt im Portal neben dem Service angezeigt. Die Dokumentation ist immer aktuell, weil sie mit dem Quellcode lebt. Ein Pull Request auf Code = ein Pull Request auf Dokumentation.
Für Teams, die Confluence gewohnt sind, ist das ein Kulturwandel — aber ein deutlich effizienterer. Dokumentation, die niemand aktualisiert, ist schlimmer als keine Dokumentation.
Plugin-Ökosystem¶
Backstage ist durch Plugins erweiterbar. Die Community und das Ökosystem bieten 2023 Plugins für:
- Kubernetes: Pod-Status direkt im Portal
- CI/CD: GitHub Actions, Jenkins, ArgoCD — Build-Status an einem Ort
- Monitoring: Grafana-Dashboards, PagerDuty-Incidents
- Cloud Cost: AWS/Azure-Kosten pro Service
- API-Docs: OpenAPI/Swagger direkt im Katalog
- Security: Snyk-Schwachstellen, SonarQube Quality Gates
Eigene Plugins werden in TypeScript/React geschrieben. Backstage ist im Wesentlichen eine React-Anwendung mit Plugin-Architektur — Frontend-Entwickler fühlen sich sofort zu Hause.
Deployment in tschechischen Unternehmen¶
Wir haben Backstage bei einer mittelgroßen Bank deployt (15 Entwicklungsteams, über 200 Microservices). Die wichtigsten Herausforderungen:
Adoption: Die größte Hürde ist nicht technischer Natur. Es geht darum, Teams davon zu überzeugen, catalog-info.yaml-Dateien in ihren Repositories zu pflegen. Lösung: Automatisierung — ein CI-Check, der Merges ohne gültige Katalogdatei blockiert.
Authentifizierung: Integration mit dem unternehmenseigenen Azure AD über OIDC. Backstage unterstützt Microsoft, GitHub, Google, Okta — Standard-Flows.
Hosting: Backstage läuft als Node.js-Anwendung + PostgreSQL. Wir haben auf AKS (Azure Kubernetes Service) deployt. Ein Helm Chart ist verfügbar, erfordert aber Anpassung.
Ergebnisse nach 6 Monaten: 95 % der Services im Katalog. Onboarding neuer Entwickler von 2 Wochen auf 3 Tage reduziert. Die Anzahl der Slack-Nachrichten mit „Wem gehört X” sank um 80 %.
Alternativen¶
Port: Ein verwaltetes Developer Portal — weniger Arbeit, aber Vendor Lock-in. Cortex: Ein ähnliches Konzept, SaaS. OpsLevel: Service Catalog + Maturity Scorecards. Backstage ist die einzige vollständig quelloffene und CNCF-unterstützte Option — für Unternehmen mit internen Anpassungsanforderungen ist es in der Regel die beste Wahl.
Platform Engineering beginnt mit einem Developer Portal¶
Backstage ist nicht nur ein Tool — es ist ein Kulturwandel. Von „jedes Team macht es auf seine Weise” zu „wir haben eine gemeinsame Plattform mit Golden Paths”. Die Investition in das Deployment zahlt sich durch schnelleres Onboarding, reduzierte kognitive Belastung und Konsistenz in der gesamten Organisation aus.
Brauchen Sie Hilfe bei der Implementierung?
Unsere Experten helfen Ihnen bei Design, Implementierung und Betrieb. Von der Architektur bis zur Produktion.
Kontaktieren Sie uns