Il problema della frammentazione
Un’azienda cresce → N repository, N pipeline CI, N dashboard, N API, N servizi, N documenti. Ogni sviluppatore perde tempo a cercare: “dov’è il runbook del servizio X?”, “chi gestisce Y?”, “come deployo Z?”. Spotify costruisce internamente un portale per centralizzare la scoperta.
Il rilascio
Backstage è rilasciato Open Source da Spotify il 16 marzo 2020. Lead: Lee Mills e team Spotify R&D. Licenza Apache 2.0. Scritto in TypeScript (React + Node.js).
Componenti core
Software Catalog
- Component — microservizio, libreria, website
- API — OpenAPI, gRPC, AsyncAPI, GraphQL
- Resource — database, queue, bucket
- System — raggruppamento logico
- Domain — business domain
- User/Group — ownership
- Template — scaffolder
Definiti in catalog-info.yaml nel repo stesso (sorgente verificata).
TechDocs
Docs-as-code: MkDocs Material con Markdown in repo, rendered nel portal. Versionate come il codice.
Software Templates
Scaffolder: crea nuovo progetto da template (repo Git + PR + CI pipeline + catalog entry) in pochi click.
Search
Cerca across catalog, docs, codice.
Plugin ecosystem
300+ plugin community:
- GitHub/GitLab/Bitbucket — pull request, insights
- Kubernetes — cluster view per servizio
- ArgoCD / FluxCD — deployment status
- Prometheus/Grafana/Datadog — metrics
- PagerDuty / Opsgenie — on-call
- Jira / Linear — issue tracker
- SonarQube — code quality
- CircleCI / GitHub Actions / Jenkins — CI
- AWS / GCP / Azure — cloud resources
Feature avanzate
- Scaffolder actions custom (Ansible, Terraform, API calls)
- Entity processors — pipeline di validazione
- Policy/RBAC — permission framework
- Notifications
- Authentication providers — GitHub, GitLab, OAuth2, SAML, OIDC, Auth0, Okta, Azure AD, Google, LDAP
Aziende che lo usano
Lo sviluppo primario è di Spotify; il progetto attrae early adopter fra grandi enterprise con cataloghi ampi di microservizi.
Concorrenti / complementari
- Port — commerciale, Backstage-alternative SaaS
- Cortex — commerciale, service catalog
- OpsLevel — commerciale
- Humanitec — IDP orchestrator
Nel contesto italiano
Backstage è adottato in:
- Enterprise italiane grandi con 100+ servizi (telco, banche, assicurazioni)
- Platform engineering team
- PA digitale — progetti con scale multi-team
- MSP — gestione cataloghi servizi cliente
- Aziende con 50+ sviluppatori che vogliono standardizzare DX
Richiede investimento in sviluppo (Backstage è un framework, non prodotto plug-and-play): team dedicati platform engineering lo customizzano con plugin interni.
Riferimenti: Backstage (Spotify, Open Source 16 marzo 2020). Licenza Apache 2.0. Scritto in TypeScript (React + Node). Core: Software Catalog, TechDocs, Software Templates, Search. 300+ plugin community.