Skills2026年4月13日·1 分钟阅读

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
Agent 就绪

Agent 可直接安装

这个资产可安装；Agent 先选择当前运行时、检查安装计划，再运行匹配命令。

Native · 98/100策略：允许
Agent 入口
任意 MCP/CLI Agent
类型
Skill
安装
Single
信任
信任等级：Established
入口
step-1.md
直接安装命令
npx -y tokrepo@latest install eb267d16-371c-11f1-9bc6-00163e2b0d79 --target codex

先 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

常见问题

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.

引用来源 (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
TokRepo 相关
Documentation toolsDevOps toolsFeatured workflows

讨论

登录后参与讨论。
还没有评论，来写第一条吧。

相关资产

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
◈首页🔍搜索👤我的