Backstage 内部开发者门户实战：服务目录、自助创建与 K8s 交付
不替换 Git、Jenkins、Argo CD 和 Kubernetes，而是用 Backstage 把它们组织成开发者真正可用的一站式入口。
摘要
当服务数量增加后，代码仓库、流水线、GitOps 应用、Kubernetes 工作负载和技术文档往往分散在不同系统中。开发者知道“系统都在”，却不知道服务归谁、从哪里创建、如何找到运行状态，也不知道文档是否仍然有效。本文围绕 Backstage 的核心能力，搭建一条可治理的内部开发者门户链路：用 Software Catalog 建立服务目录，用 Scaffolder 提供黄金路径模板，用 TechDocs 管理文档，再关联 GitHub、现有 CI/CD、Argo CD 与 Kubernetes。重点不是重复讲底层部署，而是讲实体建模、模板 API、集成边界、权限和生产治理。本文配置以 Backstage v1.53.1 官方文档与源码 Schema 为核验基线。不同 Backstage 包独立版本化，落地时仍须以本实例的/create/actions页面为准。所有域名、组织、仓库和凭据均为占位符，不包含任何真实企业数据。