Cette page est affichée en anglais. Une traduction française est en cours.
SkillsApr 13, 2026·3 min de lecture

Backstage — Open Source Developer Portal by Spotify

Backstage is an open platform for building developer portals. Created by Spotify, it provides a centralized catalog of all services, documentation, CI/CD, infrastructure, and tooling — giving developers a single pane of glass for everything they need.

AI Open Source
AI Open Source · Community
Prêt pour agents

Installation agent prête

Cet actif peut être installé après choix du runtime, vérification du plan et exécution de la commande adaptée.

Native · 98/100Policy : autoriser
Surface agent
Tout agent MCP/CLI
Type
Skill
Installation
Single
Confiance
Confiance : Established
Point d'entrée
step-1.md
Commande d'installation directe
npx -y tokrepo@latest install eb267d16-371c-11f1-9bc6-00163e2b0d79 --target codex

À exécuter après confirmation du plan en dry-run.

TL;DR
Backstage centralizes all services, docs, and tooling into one developer portal.
§01

What it is

Backstage is an open platform for building developer portals, created by Spotify and donated to the CNCF. It provides a centralized software catalog of all services, documentation, CI/CD pipelines, infrastructure, and tooling. Developers get a single pane of glass for everything they need: discovering services, reading docs, checking build status, and provisioning infrastructure through templates.

Backstage targets platform engineering teams at organizations with many microservices and teams. It reduces the cognitive overhead of navigating dozens of tools by bringing them all into one interface.

§02

Why it saves time or tokens

In large organizations, developers waste time finding which team owns a service, where the docs live, and how to access CI/CD. Backstage puts all of this in one searchable catalog. Software templates let developers provision new services with best practices baked in, reducing onboarding time from days to minutes. For AI-assisted development, Backstage provides structured context about all services that an AI agent can query.

§03

How to use

  1. Create a Backstage app: npx @backstage/create-app@latest
  2. Configure the software catalog by adding catalog-info.yaml files to your repositories
  3. Deploy Backstage and add plugins for CI/CD, monitoring, and other integrations
§04

Example

# catalog-info.yaml (placed in your repo root)
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: payment-service
  description: Handles payment processing
  annotations:
    github.com/project-slug: myorg/payment-service
    pagerduty.com/service-id: P123ABC
spec:
  type: service
  lifecycle: production
  owner: team-payments
  system: checkout
  providesApis:
    - payment-api
FeatureDescription
Software CatalogRegistry of all services and owners
TechDocsDocs-as-code rendered in Backstage
TemplatesScaffold new services from templates
SearchFind anything across the organization
Plugins100+ community plugins
§05

Related on TokRepo

§06

Common pitfalls

  • Backstage requires ongoing investment; the catalog only stays accurate if teams maintain their catalog-info.yaml files
  • Plugin compatibility across Backstage versions requires careful dependency management; version upgrades can break plugins
  • Backstage is a platform, not a product; it requires significant customization to match your organization's needs

Questions fréquentes

Is Backstage free?+

Yes. Backstage is fully open source under the Apache 2.0 license. Spotify open-sourced it and donated it to the CNCF. Several companies offer commercial Backstage hosting (Roadie, Spotify Portal) with managed infrastructure and premium plugins, but the core platform is free.

What is the software catalog?+

The software catalog is a centralized registry of all software components (services, libraries, websites, APIs) in your organization. Each component has an owner, lifecycle stage, dependencies, and links to docs, CI, and monitoring. It answers the question 'who owns this service and where are its docs?'

How do software templates work?+

Templates let developers scaffold new services from a standardized starting point. A template defines the repository structure, CI/CD configuration, and catalog entry. When a developer creates a service from a template, Backstage generates the repository, registers it in the catalog, and sets up the CI pipeline automatically.

Does Backstage support TechDocs?+

Yes. TechDocs is Backstage's built-in documentation system using a docs-as-code approach. You write Markdown in your repository, and Backstage renders it as a searchable documentation site. TechDocs uses MkDocs under the hood and integrates documentation directly into the service catalog.

How does Backstage scale for large organizations?+

Backstage supports hundreds of teams and thousands of components. The catalog uses a PostgreSQL database for persistence and supports incremental updates. Search is powered by Elasticsearch or Lunr. For large deployments, Backstage runs as a scalable web application behind a load balancer.

Sources citées (3)
  • Backstage GitHub— Backstage is an open platform for developer portals by Spotify
  • Backstage Docs— Backstage is a CNCF incubating project
  • CNCF— Software catalog and developer experience
En lien sur TokRepo
Documentation toolsDevOps toolsFeatured workflows

Fil de discussion

Connectez-vous pour rejoindre la discussion.
Aucun commentaire pour l'instant. Soyez le premier à partager votre avis.

Actifs similaires

Istio — Open Source Service Mesh for Microservices

Istio is the leading open-source service mesh. Connect, secure, control, and observe services with mTLS encryption, traffic management, and observability — all without changing application code.

Skills
AI Open Source

Huly — All-in-One Open Source Project Management Platform

Huly is an open-source alternative to Linear, Jira, Slack, and Notion. Project tracking, team chat, knowledge base, and HR tools in a single unified platform.

Skills
AI Open Source

Documenso — Open Source Document Signing Platform

Documenso is an open-source DocuSign alternative for self-hosted document signing with PDF e-signatures, audit trails, and Next.js stack.

Skills
AI Open Source

SigNoz — Open Source APM & Observability Platform

SigNoz is an open-source Datadog/New Relic alternative with logs, traces, and metrics in one platform. Native OpenTelemetry support, ClickHouse backend, and powerful dashboards.

Skills
AI Open Source
◈Accueil🔍Rechercher👤Moi