1. 课程导论：灰度发布与回滚护栏的背景、课程目标与受众、整体架构概览

1.1 灰度发布的背景与挑战

在云原生微服务架构中，API 网关作为南北向流量的统一入口，承担着路由、认证、限流、观测等核心职责。当网关配置或上游服务版本发生变更时，传统的全量发布模式存在以下风险：

• 爆炸半径大：一次错误的配置推送可能导致整个集群的流量中断。
• 回滚周期长：全量发布后发现问题，需要重新构建、审批、部署，MTTR（平均修复时间）往往超过 30 分钟。
• 缺乏精细化观测：无法在发布过程中实时对比新旧版本的请求成功率、延迟、错误码分布。

灰度发布（Canary Release）通过将小比例流量导向新版本，在低风险环境下验证变更的正确性，已成为现代 DevOps 流水线的标配能力。然而，仅有灰度发布还不够——当灰度流量触发错误率飙升时，必须依赖回滚护栏实现自动止损。

1.2 回滚护栏的定义与价值

回滚护栏是一组预定义的自动化策略，在灰度验证期间持续监控关键指标，一旦指标越界则立即触发回滚操作。其价值体现在三个维度：

1.3 课程目标

完成本课程学习后，学员将具备以下能力：

1. 设计灰度发布策略：基于 Gateway API 的权重路由、Header 匹配、镜像流量等能力，制定符合业务场景的灰度方案。
2. 实现回滚护栏：在流水线中集成 Prometheus 指标监控、SLO 评估引擎、自动回滚触发器。
3. 端到端集成验证：将灰度发布与回滚护栏嵌入 Jenkins/GitLab CI/Argo Workflows 流水线，形成可重复的自动化流程。
4. 生产级加固：处理并发发布冲突、跨集群回滚、审计日志等高级场景。

1.4 目标受众

• 平台工程 / DevOps 工程师：负责建设 CI/CD 流水线，希望引入高级发布策略。
• API 网关运维人员：管理 Kong、APISIX、Istio Ingress 等网关，需要精细化控制流量变更。
• SRE 工程师：关注服务可靠性，需要自动化回滚机制保障 SLO。
• 架构师：设计云原生发布体系，评估灰度与回滚方案的技术选型。

1.5 整体架构概览

本课程设计的整体架构分为四个核心层次，从下至上依次为：基础设施层、网关控制层、流水线编排层、观测与护栏层。下图展示了各层之间的协作关系：

1.6 核心工作流程

基于上述架构，一次完整的灰度验证与回滚护栏集成流程包含以下步骤：

1.7 课程章节地图

为帮助学员建立全局认知，下表列出了后续章节的核心主题与依赖关系：