{T}

持续交付36讲全面重写设计文档

总体定位

维度决策
组织方式按 DORA 指标体系 + Platform Engineering 现代理念重新组织
内容风格技术实践指南风格(为什么→怎么做→注意什么)
语言中文 + 英文技术术语
单篇篇幅5000-8000 字深度型
图表流程图、架构图、对比表格、数据图表,按需使用 Mermaid
代码示例包含可运行示例(YAML、Dockerfile 等)
输出粒度每篇一个 .md 文件
信息来源context7 MCP 获取最新文档 + Web 搜索补充
更新策略全面重写 + 重新组织

章节结构(10 模块 37 篇)

code
01-基础概念/
  ├─ 01-持续交付概述:定义、价值与演进
  ├─ 02-DORA 指标体系:衡量软件交付效能的黄金标准
  ├─ 03-DevOps 与 Platform Engineering:从文化到平台
  └─ 04-价值流管理:端到端交付可视化

02-配置与版本控制/
  ├─ 05-代码分支策略:Trunk-Based Development 实践
  ├─ 06-依赖管理:供应链安全与 SBOM
  └─ 07-配置管理:GitOps 与 Infrastructure as Code

03-构建系统/
  ├─ 08-构建流水线设计:从 CI 到 CD
  ├─ 09-构建缓存与加速:Bazel、Nx、Turborepo
  ├─ 10-容器镜像构建:多阶段构建与安全扫描
  └─ 11-构建资源弹性伸缩:云原生构建系统

04-测试策略/
  ├─ 12-测试金字塔与测试策略
  ├─ 13-自动化测试实践:单元、集成、E2E
  ├─ 14-测试数据管理:Test Data Management
  └─ 15-混沌工程与破坏性测试

05-部署与发布/
  ├─ 16-部署策略:蓝绿、金丝雀、渐进式交付
  ├─ 17-Feature Flag:功能开关实践
  ├─ 18-灰度发布与 A/B 测试
  └─ 19-回滚策略与故障恢复

06-环境管理/
  ├─ 20-环境策略:开发、测试、预发布、生产
  ├─ 21-Kubernetes 环境管理
  ├─ 22-环境隔离与资源配额
  └─ 23-环境自描述与可观测性

07-平台工程/
  ├─ 24-内部开发者平台(IDP)设计
  ├─ 25-开发者门户与自助服务
  ├─ 26-平台工程团队建设
  └─ 27-Backstage 实践指南

08-可观测性与监控/
  ├─ 28-三大支柱:日志、指标、链路追踪
  ├─ 29-SLO/SLI/SLA 实践
  ├─ 30-告警策略与 On-Call 管理
  └─ 31-发布质量保障

09-安全与合规/
  ├─ 32-DevSecOps:安全左移
  ├─ 33-供应链安全:SBOM、签名、验证
  └─ 34-合规自动化:Policy as Code

10-移动端与特殊场景/
  ├─ 35-移动 App 持续交付
  ├─ 36-MLOps:机器学习模型交付
  └─ 37-实践案例:企业级持续交付平台构建

单篇文章模板

每篇文章遵循统一的结构模板:

markdown
# XX | 文章标题

## 背景与问题定义
- 这个实践要解决什么问题
- 为什么这个问题重要(关联 DORA 指标)

## 核心概念
- 关键术语定义
- 与其他概念的关系(Mermaid 图)

## 架构设计
- 整体架构(Mermaid 架构图)
- 关键组件与交互(Mermaid 时序图)

## 实现方案
- 工具链选型(对比表格)
- 可运行的配置示例(代码块)
- 分步实施指南

## 最佳实践
- 业界推荐做法
- 常见反模式与规避方法

## 效果度量
- 关键指标定义
- 数据图表示例(Mermaid xychart)

## 总结
- 核心要点回顾
- 延伸阅读

实施策略

  • 信息来源:使用 context7 查询 GitHub Actions、Kubernetes、ArgoCD、Backstage 等工具的最新文档;使用 Web 搜索补充 DORA 报告、Platform Engineering 社区等最新动态
  • 生成顺序:按模块顺序逐篇生成,每篇完成后即时写入文件
  • 质量控制:每篇确保包含至少 1 个 Mermaid 图、1 个对比表格、1 个可运行代码示例
  • 目录结构:在项目根目录下按模块创建子目录,每个目录下包含该模块的文章