容量水位预测与CI／CD发布准入质量门禁 - 第1节
1.1 质量门禁：发布前的“安检闸机”
质量门禁（Quality Gate）是软件交付流水线中一组自动化的质量校验关卡。它像机场安检闸机一样，只有通过所有检查项的制品才能继续流向下一环节。在容量水位发布准入场景中，质量门禁的核心作用是拦截不符合容量基线的版本上线。
| 维度 | 传统门禁（仅功能测试） | 容量水位门禁（本课程） |
|---|---|---|
| 检查对象 | 功能正确性、代码规范 | CPU/内存/连接数/吞吐量/响应时间 |
| 数据来源 | 单元测试、静态扫描 | 压测平台、APM、监控时序库 |
| 判定标准 | 通过/失败（二元） | 水位阈值 + 趋势漂移 + 余量评估 |
| 阻断动作 | 禁止合并代码 | 禁止发布 + 触发容量告警 + 回滚候选 |
关键认知：质量门禁不是“测一次就过”，而是持续集成/持续部署（CI/CD）管道中每个阶段的守卫。容量水位门禁是其中最晚、最重的一道闸。
1.2 容量水位：系统的“血压与血氧”
容量水位（Capacity Watermark）是对系统资源使用程度与剩余能力的量化描述。它不是一个单一指标，而是一组反映系统健康度的多维水位线。
- 基础水位：CPU 使用率、内存占用率、磁盘 I/O 等待、网络带宽利用率。
- 连接水位：数据库连接池占用率、线程池活跃度、TCP 连接数。
- 业务水位：每秒请求数（RPS）、平均/99 分位延迟、错误率。
- 余量水位：距离资源上限的剩余百分比、弹性扩容触发阈值。
水位管理遵循“三区模型”：
- 安全区（水位 < 60%）：正常运营，无需干预。
- 关注区（60% ≤ 水位 < 80%）：需观察趋势，准备预案。
- 危险区（水位 ≥ 80%）：必须立即扩容或降级，禁止新发布。
实践建议：水位阈值不应是静态数字。建议根据历史压测数据，按“峰值水位 + 20% 安全余量”动态校准。例如压测得到单机极限 RPS 为 2000，则发布准入水位应设为 1600 RPS。
1.3 发布准入：三合一的决策引擎
发布准入（Release Admission）是将质量门禁的判定结果与容量水位的实时数据融合后，做出的“是否允许版本上线”的最终决策。它不是简单的“门禁通过 + 水位正常”与门，而是包含三个层面的综合评估：
| 评估层 | 输入 | 输出 |
|---|---|---|
| 门禁层 | 自动化测试、代码扫描、安全审计 | 门禁分数 / 阻断项列表 |
| 水位层 | 实时监控、压测报告、容量预测 | 水位等级（安全/关注/危险） |
| 准入层 | 门禁结果 + 水位等级 + 变更影响面 | 允许发布 / 灰度发布 / 拒绝发布 |
常见误区：很多团队只做“门禁通过就发布”，忽略了容量水位。结果往往是：代码质量没问题，但上线后因为资源争抢导致雪崩。容量水位是发布准入的“最后一公里”防线。
1.4 课程目标与学习路径
本课程旨在帮助 SRE 与 DevOps 工程师建立从“指标采集”到“自动阻断”的完整容量水位发布准入体系。完成学习后，你将能够：
- 设计并实现基于 Prometheus + Grafana 的容量水位监控面板。
- 编写质量门禁规则，将水位数据接入 CI/CD 管道（Jenkins/GitLab CI/ArgoCD）。
- 构建发布准入决策逻辑，支持灰度比例自动调整与一键回滚。
- 通过混沌工程验证准入策略的有效性，避免“纸面门禁”。
学习路径分为四个阶段：
| 阶段 | 章节范围 | 核心产出 |
|---|---|---|
| 基础篇 | 第 1-5 章 | 容量水位指标体系 + 门禁规则模板 |
| 工具篇 | 第 6-12 章 | PromQL 水位查询 + 门禁插件开发 |
| 实战篇 | 第 13-22 章 | 端到端准入流水线 + 灰度发布策略 |
| 进阶篇 | 第 23-30 章 | 容量预测 + 混沌验证 + 运营复盘 |
学习建议：每章结束后，在实验环境（推荐 minikube + 模拟压测工具）中复现本章的配置与脚本。不要跳过“水位阈值校准”和“门禁误报处理”两个难点，它们是生产落地的关键。