Kolik času vaši vývojáři tráví hledáním, kdo vlastní jaký mikroservis? Kde je dokumentace? Jak se nasazuje? Jaké má dependencies? Backstage od Spotify — nyní CNCF incubating projekt — řeší přesně tohle. Jedno místo pro celý software ekosystém vaší organizace.
Co je Backstage¶
Backstage je open-source platforma pro budování developer portálů. Spotify ho vyvinulo interně pro svých 2000+ inženýrů a v roce 2020 ho open-sourcovalo. V roce 2023 je to CNCF incubating projekt s masivní komunitou — přes 100 pluginů, adopce u Spotify, Netflix, American Airlines, HP, IKEA a desítek dalších.
Jádro tvoří tři pilíře: Software Catalog (registr všech služeb, knihoven, pipeline, infrastruktury), Software Templates (golden paths pro vytváření nových projektů) a TechDocs (dokumentace jako kód, přímo v repozitáři).
Software Catalog — konec „kdo to vlastní?”¶
Každá služba, knihovna, API, databáze, pipeline — vše je entity v katalogu. Definované YAML souborem přímo v repozitáři:
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
name: payment-service
description: Platební microservice
tags: [java, spring-boot, payments]
spec:
type: service
lifecycle: production
owner: team-payments
dependsOn: [component:user-service]
Výsledek: otevřete Backstage, najdete payment-service, vidíte kdo ho vlastní (team-payments), v jakém je stavu (production), jaké má závislosti, kde běží, jaké má API, jak ho nasadit. Žádné slackování „hele, kdo vlastní ten payment service?”.
Software Templates — golden paths¶
Nový vývojář potřebuje vytvořit mikroservis. Bez Backstage: klonuje existující projekt, smaže co nepotřebuje, zapomene na CI/CD, nastaví špatně monitoring. S Backstage: klikne „Create”, vybere template „Java Spring Boot Service”, vyplní název a popis — a dostane kompletní repozitář s CI/CD pipeline, Dockerfile, Helm chartem, monitoring dashboardem a registrací v katalogu.
Templates definujete jako kód (Nunjucks + YAML). Organizace tak kodifikuje best practices — každý nový projekt začíná správně. To je podstata platform engineering: zlaté cesty, ne zákazy.
TechDocs — dokumentace, která žije¶
Backstage integruje docs-as-code přístup. Markdown soubory v repozitáři se automaticky buildují (MkDocs) a zobrazují přímo v portálu vedle služby. Dokumentace je vždy aktuální, protože žije se zdrojovým kódem. Pull request na kód = pull request na dokumentaci.
Pro týmy zvyklé na Confluence to je kulturní změna — ale výrazně efektivnější. Dokumentace, kterou nikdo neaktualizuje, je horší než žádná dokumentace.
Plugin ekosystém¶
Backstage je rozšiřitelný přes pluginy. Komunita a ecosystem v roce 2023 nabízí pluginy pro:
- Kubernetes: stav podů přímo v portálu
- CI/CD: GitHub Actions, Jenkins, ArgoCD — build status na jednom místě
- Monitoring: Grafana dashboardy, PagerDuty incidenty
- Cloud cost: AWS/Azure cost per service
- API docs: OpenAPI/Swagger přímo v katalogu
- Security: Snyk vulnerabilities, SonarQube quality gates
Vlastní pluginy píšete v TypeScriptu/Reactu. Backstage je v podstatě React aplikace s plugin architekturou — frontend vývojáři se cítí jako doma.
Nasazení v české enterprise¶
Nasazovali jsme Backstage u středně velké banky (15 dev týmů, 200+ mikroservisů). Hlavní výzvy:
Adopce: největší překážka není technická. Je to přesvědčit týmy, aby udržovaly catalog-info.yaml v repozitářích. Řešení: automatizace — CI check, který nepustí merge bez platného catalog souboru.
Autentizace: napojení na firemní Azure AD přes OIDC. Backstage podporuje Microsoft, GitHub, Google, Okta — standardní flow.
Hosting: Backstage běží jako Node.js aplikace + PostgreSQL. Nasadili jsme na AKS (Azure Kubernetes Service). Helm chart je dostupný, ale vyžaduje customizaci.
Výsledek po 6 měsících: 95 % služeb v katalogu. Onboarding nového vývojáře z 2 týdnů na 3 dny. Počet Slack zpráv „kdo vlastní X” klesl o 80 %.
Alternativy¶
Port: managed developer portál, méně práce, ale vendor lock-in. Cortex: podobný koncept, SaaS. OpsLevel: service catalog + maturity scorecards. Backstage je jediný plně open-source a CNCF-backed — pro enterprise s interními požadavky na customizaci je to obvykle nejlepší volba.
Platform engineering začíná developer portálem¶
Backstage není jen nástroj — je to změna kultury. Od „každý tým si řeší věci po svém” k „máme společnou platformu s golden paths”. Investice do nasazení se vrátí v rychlosti onboardingu, snížení kognitivní zátěže a konzistenci napříč organizací.