1. 课程导论：发布门禁与灰度发布的概念、课程目标与学习路径
1.1 为什么需要发布门禁与灰度发布？
现代软件交付节奏从月级提速到天级甚至小时级，每一次代码变更都可能引入回归、性能劣化或安全漏洞。传统“全量发布、事后回滚”的模式在微服务架构下风险急剧放大——一次错误的配置推送可能影响数千个实例。为此，行业逐渐形成两道关键防线：发布门禁（Release Gate） 在发布前自动拦截不合格变更；灰度发布（Canary Release） 在发布中逐步放量、实时验证，将爆炸半径控制在最小范围。
核心认知： 发布门禁解决“能不能发”的问题，灰度发布解决“怎么安全地发”的问题。两者结合构成从代码提交到全量上线的安全通道。
1.2 核心概念速览
| 概念 | 定义 | 典型触发时机 | 失败后果 |
|---|---|---|---|
| 发布门禁 | 一组自动化检查条件，必须全部通过才能进入下一发布阶段 | 构建完成、部署前、流量切换前 | 阻断发布流水线，通知责任人 |
| 灰度发布 | 将新版本先暴露给小部分用户/实例，观察指标正常后再逐步扩大范围 | 部署后、流量切换时 | 自动回滚或暂停放量 |
| 准入接口 | 灰度发布过程中，由外部系统（如监控、混沌工程）调用的决策端点，决定是否继续放量 | 每轮灰度批次结束后 | 拒绝下一批次放量 |
| 发布基线 | 当前生产环境的稳定版本，作为灰度对比的基准 | 灰度开始前锁定 | 无法准确评估新版本影响 |
1.3 发布门禁与灰度发布的关系
两者并非独立运作，而是构成一条完整的安全发布链路：
- 代码提交 → 构建门禁：单元测试通过率、代码扫描、构建成功率。
- 构建完成 → 部署门禁：制品签名校验、镜像漏洞扫描、环境一致性检查。
- 部署完成 → 灰度准入：调用准入接口，判断当前批次错误率、延迟、资源水位是否达标。
- 灰度批次间 → 持续准入：每轮放量前再次调用准入接口，结合实时监控数据决策。
- 全量确认 → 发布完成：最终门禁确认所有指标正常，关闭灰度流程。
1.4 课程目标
完成本课程后，你将能够：
- 设计发布门禁体系：根据团队成熟度定义门禁等级（强制/警告/可选），并集成到 CI/CD 流水线。
- 实现灰度发布准入接口：设计 RESTful/gRPC 接口规范，对接监控、日志、混沌工程等数据源。
- 编写准入决策引擎：基于多维度指标（错误率、P99 延迟、CPU 使用率、业务成功率）计算放量分数。
- 构建灰度发布控制面：管理灰度批次、流量路由、自动回滚策略。
- 落地生产级案例：通过一个完整的微服务发布场景，串联门禁、灰度、准入接口与可观测性。
1.5 学习路径与章节地图
课程共 30 章，按“基础 → 设计 → 实现 → 进阶 → 实战”五阶段组织：
| 阶段 | 章节范围 | 核心产出 |
|---|---|---|
| 基础篇 | 第 1-5 章 | 理解门禁与灰度概念、技术选型、接口协议 |
| 设计篇 | 第 6-12 章 | 门禁规则引擎设计、准入接口规范、灰度策略模型 |
| 实现篇 | 第 13-20 章 | Go/Java 实现准入服务、集成 Prometheus/K8s |
| 进阶篇 | 第 21-26 章 | 多集群灰度、混沌工程准入、安全门禁 |
| 实战篇 | 第 27-30 章 | 端到端项目：电商系统灰度发布 + 准入自动化 |
1.6 前置知识与环境准备
前置技能：
- 熟悉 Git 工作流、CI/CD 基本概念（Jenkins/GitLab CI/GitHub Actions 任一即可）。
- 了解 RESTful API 设计基础（HTTP 方法、状态码、JSON 序列化）。
- 对 Kubernetes 有基本认知（Pod、Service、Deployment、Ingress）。
- 掌握至少一门编程语言（课程示例使用 Go 1.21+ 和 Java 17+）。
⚠ 注意： 本课程不从头教授编程基础或 K8s 安装。如果你对上述前置技能完全陌生，建议先完成对应入门教程再开始本课程。
1.7 课程配套资源
- 代码仓库：每个实现章节附带可运行的示例代码，包含单元测试和集成测试。
- API 规范文档：OpenAPI 3.0 定义文件，可直接导入 Postman 或 Swagger UI。
- 部署清单：K8s YAML 和 Docker Compose 文件，用于本地或测试环境快速启动。
- 指标模拟器：用于模拟灰度过程中的监控数据，方便在没有真实生产数据时调试准入接口。
现在，让我们从第 2 章开始，深入发布门禁的规则引擎设计。