持续交付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 个可运行代码示例
- 目录结构:在项目根目录下按模块创建子目录,每个目录下包含该模块的文章