internal-developer-platform

内部开发者平台的自助入口与黄金路径

补充说明

内部开发者平台（IDP）不是“再做一个门户”，而是把创建服务、申请环境、发布、观测和排障的黄金路径做成自助流程，并用策略护栏限制风险。门户只是入口，背后必须有模板、流水线、IaC 和权限自动化。

判断是否值得建平台：至少 3 个团队、2 个以上重复工作流、手工交付时间超过 1 天。否则先用文档和脚本。

常用示例

黄金路径能力清单：

Backstage 软件目录实体：

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: order-service
  annotations:
    backstage.io/techdocs-ref: dir:.
spec:
  type: service
  lifecycle: production
  owner: group:default/checkout
  system: commerce

Backstage 脚手架模板参数：

apiVersion: scaffolder.backstage.io/v1beta3
kind: Template
metadata:
  name: golden-path-service
spec:
  parameters:
    - title: 基本信息
      required: [name, owner, tier]
      properties:
        name:
          type: string
        owner:
          type: string
        tier:
          type: string
          enum: [gold, silver, bronze]
  steps:
    - id: fetch
      name: 生成骨架
      action: fetch:template
      input:
        url: ./skeleton
        values:
          name: ${{ parameters.name }}

决策规则：

• 低风险变更（dev 环境、无状态服务）默认自助，不需要人工审批。
• 生产数据库 schema、网络和权限变更保留审批，但审批要在平台内完成。
• 平台 API 和模板必须版本化；破坏性变更提前两个版本公告。

易错点与排错

• 只做门户不做自动化，点完按钮仍要开工单，体验没有改善。
• 强制所有团队迁移，遗留系统没有迁移路径，平台变成负担。
• 模板只生成代码，不含 CI/CD、可观测和安全配置。
• 平台自身没有 SLO，故障时业务无法发布且无人负责。
• 模板没有版本和升级策略，各团队复制后分叉，无法统一修复。
• 权限模型后补，多租户之间互相可见。
• 只用“访问量”衡量成功，不看交付周期和自助完成率。
• 平台团队闭门造车，不接收反馈，成为新的瓶颈。

读完自测

合上页面，先回答，再展开对照。

1. IDP 和普通开发者门户的区别是什么？
2. 什么情况下不值得自建 IDP？
3. 平台自身为什么也需要 SLO？

相关条目

• backstage — 开发者门户
• platform-engineering-roadmap — 平台建设路线
• argocd — GitOps 交付
• crossplane — 云资源自助申请
• terraform — 基础设施即代码