Projekt anfragen
Hände auf der Tastatur eines Laptops, auf dem Bildschirm ist Quelltext zu sehen

Backstage · Eignung, Aufbau, Betrieb

Backstage Developer Portal: Einführung, Integration und Betrieb

Backstage bündelt Ihre Dienste, Besitzverhältnisse und Startpfade in einem Portal. SKAFFON prüft zuerst, ob es zu Ihnen passt, baut Katalog und Templates auf und betreibt das Portal auf Wunsch.

Projekt anfragen Zur Go/No-Go-Matrix
  • Software Catalog und Templates
  • Anbindung an Kubernetes und Argo CD
  • Anmeldung per OIDC
  • Betrieb auf Kubernetes mit PostgreSQL

Autor: Ibrahim Yesilay, Gründer und Geschäftsführer Stand:

01Einordnung

Backstage ist ein Framework, kein fertiges Produkt

Backstage ist ein Open-Source-Framework für Developer-Portale: Es bündelt Software- und Infrastrukturinformationen in einem Katalog und bietet Vorlagen, mit denen Teams neue Projekte nach Ihren Standards starten. Das Projekt ist laut Backstage-Dokumentation CNCF-Incubation-Projekt und wurde von Spotify gestartet.

Sie bauen Ihr Portal damit und betreiben es. Kosten und Aufwand entstehen vor allem bei Pflege, Plugins und Datenqualität im Katalog, nicht bei der Installation. Wer ein fertiges Portal als Dienst sucht, vergleicht auch kommerzielle Angebote; dazu beraten wir produktneutral.

SKAFFON berät herstellerneutral, ob Backstage, ein kommerzielles Portal oder ein schlankerer Weg zu Ihnen passt. Das übergeordnete Thema, die interne Entwicklerplattform, behandelt Platform Engineering.

02Funktionen

Was Backstage laut Dokumentation mitbringt

  • Software Catalog

    Verwaltung von Software wie Microservices, Bibliotheken, Datenpipelines und Websites.

  • Software Templates

    Schneller Projektstart mit den Standardwerkzeugen der Organisation.

  • TechDocs

    Dokumentation als Code, direkt neben dem Quelltext gepflegt.

  • Plugin-Ökosystem

    Erweiterungen für Anbindungen, die Ihr Portal braucht.

03Eignung

Go/No-Go-Matrix: Trägt Backstage bei Ihnen?

Wir bewerten die folgenden Kriterien im Assessment gemeinsam mit Ihrem Platform-Team. Ergibt die Matrix ein Nein, sagen wir das und empfehlen den kleineren Weg. Ergibt sie ein Ja, folgt die Umsetzung.

Eignungskriterien für Backstage mit Konsequenz
KriteriumSpricht für BackstageSpricht dagegenKonsequenz
Anzahl EntwicklungsteamsMehrere Teams mit ähnlichen AufgabenEin bis zwei TeamsBei wenigen Teams reichen oft Wiki, Templates im Repository und gute Pipelines
Besitz und AuffindbarkeitUnklar, wem welcher Dienst gehört; Wissen verstreutKatalog ist bereits gepflegt und auffindbarDer Katalog ist der Kern; ohne Pflegeprozess veraltet er
Eigenentwicklungs-KapazitätTeam kann eine Portal-Anwendung samt Plugins dauerhaft pflegenKeine Kapazität für Pflege und UpdatesOhne feste Kapazität drohen Wartungsstau; Betriebsübernahme prüfen
Standardisierte StartpfadeWiederkehrende Aufgaben wie „neuer Dienst“, „Datenbank bestellen“Jedes Projekt ist ein SonderfallTemplates sind nur sinnvoll, wenn Standards existieren
IdentitätOIDC-Anbindung an Ihre Identitätsverwaltung möglichKeine zentrale IdentitätPortal-Rechte brauchen eine saubere Identitätsquelle
ProduktverantwortungEine Person oder Rolle verantwortet das PortalNiemandOhne Produktverantwortung veraltet das Portal

04Vorgehen

Von der Entscheidungsvorlage bis zum gepflegten Katalog

  1. 01

    Eignungsprüfung

    Ergebnis: Entscheidungsvorlage

    Die Matrix, angewendet auf Ihre Organisation; das Ergebnis ist eine Entscheidungsvorlage mit Annahmen.

  2. 02

    Katalog-Modell

    Ergebnis: Katalog-Modell

    Welche Entitäten (Dienste, Bibliotheken, Teams, Ressourcen), wie Besitz und Abhängigkeiten gepflegt werden und wie der Katalog aktuell bleibt.

  3. 03

    Templates

    Ergebnis: Startpfade

    Wenige, gut gepflegte Startpfade statt vieler Vorlagen auf Vorrat; Anbindung an Repository-Erzeugung und Pipelines.

  4. 04

    Integration

    Ergebnis: Anbindungen

    Kubernetes-Sicht, GitOps-Status mit Argo CD, Bereitstellung von Cloud-Ressourcen über Crossplane oder Infrastructure as Code, Zugriffsrechte über OIDC.

  5. 05

    Betrieb

    Ergebnis: laufendes Portal

    Hosting des Portals auf Kubernetes mit PostgreSQL, Updates, Sicherung, Zugriffsschutz.

  6. 06

    Pflegeprozess

    Ergebnis: gepflegter Katalog

    Dokumentation, Einweisung Ihres Teams und ein Pflegeprozess, damit der Katalog aktuell bleibt.

Prinzip

Das Portal zeigt an, Git und die Plattform setzen durch

Das Portal ruft keine Cloud-Konten direkt mit weitreichenden Rechten auf. Änderungen laufen über Git, Argo CD liefert aus, Cloud-Ressourcen entstehen über Crossplane oder Infrastructure as Code.

05Referenzarchitektur

So fügt sich Backstage in Ihre Plattform ein

Das Portal läuft als Anwendung im Cluster, nutzt PostgreSQL als Datenbank und authentifiziert Nutzer per OIDC gegen Ihre Identitätsverwaltung. Templates erzeugen Repositories und Pull Requests, Argo CD liefert aus, und der Status erscheint im Portal.

Referenzarchitektur Backstage Developer Portal Entwickler melden sich per OIDC über die Identitätsverwaltung an Backstage im Kubernetes-Cluster an. Backstage nutzt PostgreSQL. Templates erzeugen Repositories und Pull Requests in Git, Argo CD liefert aus und meldet den Status zurück, Crossplane oder Infrastructure as Code stellt Cloud-Ressourcen bereit. Entwickler/in Login Ihre Identitäts- verwaltung OIDC Kubernetes-Cluster Backstage Software Catalog Templates TechDocs PostgreSQL Git Repositories, Pull Requests Argo CD GitOps-Auslieferung Crossplane / IaC Infrastruktur als Code Cloud-Ressourcen Template erzeugtRepo/PR liefert aus Status im Portal Das Portal zeigt an. Git und Plattform setzen durch.
Das Portal zeigt an, Git und Plattform setzen durch.
Referenzarchitektur Backstage Developer Portal Entwickler melden sich per OIDC über die Identitätsverwaltung an Backstage im Kubernetes-Cluster an. Backstage nutzt PostgreSQL. Templates erzeugen Repositories und Pull Requests in Git, Argo CD liefert aus und meldet den Status zurück, Crossplane oder Infrastructure as Code stellt Cloud-Ressourcen bereit. Entwickler/in Ihre Identitäts- verwaltung Login OIDC Kubernetes-Cluster Backstage Software Catalog Templates TechDocs PostgreSQL Template erzeugtRepo/PR Status im Portal Git Repositories, Pull Requests liefert aus Argo CD GitOps-Auslieferung Crossplane / IaC Infrastruktur als Code Cloud-Ressourcen Das Portal zeigt an. Git und Plattform setzen durch.
Das Portal zeigt an, Git und Plattform setzen durch.

06Betrieb

Portalbetrieb auf Kubernetes mit PostgreSQL

Auf Wunsch übernehmen wir den Betrieb des Portals: Hosting auf Kubernetes mit PostgreSQL, Updates, Sicherung und Zugriffsschutz. Die Cluster-Grundlage klären wir in der Kubernetes-Beratung, die Auslieferung über GitOps mit Argo CD.

  • Hosting auf Kubernetes mit PostgreSQL
  • Updates und Sicherung
  • Zugriffsschutz

Platform Engineering

Handgeschriebener Quelltext auf einem Whiteboard in einem Büro

07Rechte

Welche Rechte das Portal bekommt und welche nicht

Vertiefung zu Supply Chain und Zugriff: DevSecOps und Supply Chain.

  • Portal-Zugriff über OIDC gegen Ihre Identitätsverwaltung.
  • Rollen nach minimalen Rechten, getrennt nach Lesen und Auslösen von Templates.
  • Das Portal erhält nur technische Konten mit eng begrenzten Rechten.
  • Zugangsdaten liegen in einem Secret-Store.

08Abgrenzung

Wann ein kleinerer Weg besser ist als Backstage

Backstage lohnt sich, wenn

  • mehrere Teams mit ähnlichen Aufgaben unklare Besitzverhältnisse haben,
  • eine Person oder Rolle das Portal verantwortet,
  • wiederkehrende Aufgaben als Startpfade standardisiert werden können.

Besser anders lösen, wenn

  • Sie ein fertig gehostetes Portal als Produkt ohne Eigenentwicklung suchen,
  • Sie ein oder zwei Teams haben und kein Besitz- oder Auffindbarkeitsproblem,
  • es keine Produktverantwortung für das Portal gibt,

09Angebot

Was ein Portalprojekt größer oder kleiner macht

Das Angebot richtet sich nach diesen Faktoren:

  • Zahl der Teams und Entitäten im Katalog
  • Zahl der Templates
  • Integrationstiefe
  • Identitäts- und Sicherheitsvorgaben
  • ob SKAFFON den Portalbetrieb übernimmt

Welches Problem soll Ihr Portal lösen?

Beschreiben Sie, welches Problem das Portal für Ihre Teams lösen soll und wer es verantworten würde. Übersicht aller Angebote: Leistungen.

Projekt anfragen