platform-engineer

用途

Platform Engineer 技能提供内部开发者平台（IDP）方面的专业能力，专注于开发者体验优化、自助式基础设施和 Golden Path 模板。它使用 Backstage、Crossplane 和 GitOps 构建平台，以降低开发者的认知负担。

主要能力

内部开发者平台

构建自助式基础设施平台
使用 Backstage 实施服务目录
创建开发者门户和文档中心
管理平台治理与策略

Golden Path 模板

开发标准化应用模板
创建基础设施即代码模块
实施安全与合规控制
自动化服务接入

GitOps 与基础设施

使用 ArgoCD/Flux 实施 GitOps 工作流
管理 Kubernetes 集群与 Operator
配置 Crossplane 实现云资源抽象
设置临时环境

开发者体验

度量 DORA 指标和 DevEx KPI
降低开发者认知负担
实施内部工具与自动化
管理开发者入职与培训

使用方式

该技能适用于以下场景：

从零构建内部开发者平台（IDP）
实施服务目录或开发者门户（Backstage）
为微服务（Spring Boot、Node.js、Go）创建 Golden Path 模板
将云资源（RDS、S3）抽象为自定义平台 API（Crossplane）
设计自助式临时环境
度量 DORA 指标和开发者体验（DevEx）KPI

工作流示例：基础设施组合（Crossplane）

目标：允许开发者通过 Kubernetes 清单（YAML）请求 PostgreSQL 数据库，而无需了解 AWS 细节。

步骤：

定义复合资源定义（XRD）：

# postgres-xrd.yaml
apiVersion: apiextensions.crossplane.io/v1
kind: CompositeResourceDefinition
metadata:
  name: xpostgresqlinstances.database.example.org
spec:
  group: database.example.org
  names:
    kind: XPostgreSQLInstance
    plural: xpostgresqlinstances
  claimNames:
    kind: PostgreSQLInstance
    plural: postgresqlinstances
  versions:
    - name: v1alpha1
      served: true
      referenceable: true
      schema:
        openAPIV3Schema:
          type: object
          properties:
            spec:
              properties:
                storageGB:
                  type: integer

定义 Composition（AWS 实现）：

# aws-composition.yaml
apiVersion: apiextensions.crossplane.io/v1
kind: Composition
metadata:
  name: xpostgresqlinstances.aws.database.example.org
spec:
  compositeTypeRef:
    apiVersion: database.example.org/v1alpha1
    kind: XPostgreSQLInstance
  resources:
    - base:
        apiVersion: rds.aws.crossplane.io/v1alpha1
        kind: DBInstance
        spec:
          forProvider:
            region: us-east-1
            dbInstanceClass: db.t3.micro
            masterUsername: masteruser
            allocatedStorage: 20
      patches:
        - fromFieldPath: "spec.storageGB"
          toFieldPath: "spec.forProvider.allocatedStorage"

开发者体验：开发者应用以下清单：

apiVersion: database.example.org/v1alpha1
kind: PostgreSQLInstance
metadata:
  name: my-db
  namespace: my-app
spec:
  storageGB: 50

Crossplane 自动供给 RDS 实例。

适用场景

中型科技公司希望将开发者入职时间从 2 周缩短到 2 天
微服务平台需要缩短新服务的上线时间
需要让开发者在不直接访问云控制台的情况下供给云资源

最佳实践

平台设计

聚合而非替代：链接原生工具，不要重建它们
Golden Path 而非 Golden Cage：提供价值，不强制使用
开发者体验优先：将开发者视为客户
迭代改进：从小处着手，根据反馈迭代

自助服务

快速供给：在几分钟内完成资源供给
清晰文档：自文档化模板和工作流
逃生舱：允许在需要时手动覆盖
反馈循环：收集并响应开发者反馈

治理

默认安全：将安全嵌入模板，而非附加组件
合规自动化：自动化合规检查
成本可见性：向开发者展示成本影响
审计追踪：记录所有操作以便问责

运维

高可用：平台必须与生产环境一样可靠
监控：监控平台健康度和采用指标
事件响应：为平台问题准备运行手册
持续改进：定期进行平台健康审查

模式与模板

模式 1：Golden Path 仓库

用例：集中式模板管理。

/templates
  /spring-boot-microservice
    /src
    /Dockerfile
    /chart
    /catalog-info.yaml
    /mkdocs.yml
  /react-frontend
    /src
    /Dockerfile
    /nginx.conf
  /python-data-worker
    /src
    /requirements.txt

模式 2：记分卡（游戏化）

用例：通过 Backstage 鼓励最佳实践。

青铜级别：

有 catalog-info.yaml
有 README.md
CI 构建通过

白银级别：

代码覆盖率 > 80%
在 Prometheus 中定义了告警
存在运行手册链接

黄金级别：

跟踪 DORA 指标
安全扫描通过（0 个高/严重）
定义了 SLO

模式 3：TechDocs（文档即代码）

用例：保持文档与代码紧密相连。

# mkdocs.yml
site_name: My Service Docs
nav:
  - Home: index.md
  - API: api.md
  - Architecture: architecture.md
  - Runbook: runbook.md
plugins:
  - techdocs-core

集成模式

kubernetes-specialist：平台工程师定义抽象 PostgreSQL 声明 → Kubernetes 专家实现 Operator/驱动逻辑。协作设计 IDP 的底层集群拓扑。工具：Crossplane、ArgoCD。
security-engineer：平台工程师构建模板 → 安全工程师在 CI 骨架中添加 SAST/SCA 步骤。协作实现 Golden Path 中的“默认安全”配置。工具：OPA Gatekeeper、Snyk。
sre-engineer：平台工程师暴露“创建告警”能力 → SRE 定义默认告警规则。协作定义服务的 SLI/SLO 模板。工具：Prometheus、PagerDuty。
backend-developer：平台工程师提供“创建服务”按钮 → 后端开发者使用它发布代码。协作收集模板反馈（“是否过于臃肿？”）。工具：Backstage。

限制

资料中未提供关于该技能的具体收费、价格、平台限制或效果保证等信息。