3. 流水线阶段划分：微服务CI/CD流水线的典型阶段

微服务CI/CD流水线是将代码从提交到生产发布的全过程自动化、标准化、可观测化的核心载体。一个设计良好的流水线通常划分为八个典型阶段，每个阶段承载特定的质量门禁与SLI采集点。本章详细定义各阶段的范围、输入输出、关键SLI口径及测试验证流程。

3.1 流水线八阶段总览

下表列出了微服务CI/CD流水线的八个典型阶段及其核心职责：

3.2 流水线阶段流程SVG图

下图展示了微服务CI/CD流水线八个阶段的串联关系与质量门禁位置：

3.3 各阶段详细定义与SLI口径

3.3.1 代码提交阶段

• 触发条件：开发者向目标分支（如main、release）推送代码或创建Pull Request。
• 输入：源代码变更、提交信息、分支策略。
• 输出：合规检查报告、流水线触发事件。
• 关键SLI：
  • 提交频率（次/天）
  • 提交大小（变更文件数、代码行数）
  • 提交合规率（符合Conventional Commits的比例）

3.3.2 构建阶段

• 输入：源代码、依赖声明文件（pom.xml、go.mod等）。
• 输出：构建产物（JAR/WAR/Docker镜像）、依赖清单。
• 关键SLI：
  • 构建成功率（%）
  • 构建时长（P50/P95，单位秒）
  • 依赖缓存命中率（%）

3.3.3 单元测试阶段

• 输入：构建产物、测试用例代码。
• 输出：测试报告、覆盖率报告。
• 关键SLI：
  • 测试通过率（%）
  • 代码行覆盖率（%）
  • 分支覆盖率（%）
  • 测试执行时长（秒）

3.3.4 集成测试阶段

• 输入：服务镜像、依赖服务（Mock或真实实例）、契约文件。
• 输出：集成测试报告、接口兼容性报告。
• 关键SLI：
  • 接口调用成功率（%）
  • 接口响应时间P95（ms）
  • 契约兼容性通过率（%）

3.3.5 安全扫描阶段

• 输入：构建产物、基础镜像、依赖清单。
• 输出：漏洞报告、合规审计报告。
• 关键SLI：
  • 高危漏洞数（个）
  • 扫描时长（秒）
  • 漏洞修复率（%）

3.3.6 部署阶段

• 输入：服务镜像、部署配置（K8s YAML/Helm Chart）、环境信息。
• 输出：部署状态、Pod健康检查结果。
• 关键SLI：
  • 部署成功率（%）
  • 部署时长（秒）
  • 回滚率（%）
  • 灰度期间错误率（%）

3.3.7 验收测试阶段

• 输入：已部署的服务实例、E2E测试脚本、业务场景数据。
• 输出：验收测试报告、业务指标验证结果。
• 关键SLI：
  • 验收通过率（%）
  • 关键业务场景响应时间P95（ms）
  • 错误率（%）

3.3.8 发布阶段

• 输入：验收通过确认、发布审批、流量切换策略。
• 输出：全量上线状态、监控告警确认。
• 关键SLI：
  • 发布时长（秒）
  • 错误预算消耗（%）
  • 发布后5分钟错误率（%）
  • 发布回滚次数（次）

3.4 测试验证流程与SLI采集架构

测试验证流程贯穿流水线各阶段，确保每个质量门禁都有对应的自动化验证手段。下图展示了SLI采集与测试验证的协同架构：

3.5 阶段间依赖与阻断策略

流水线各阶段之间存在严格的依赖关系，下游阶段必须等待上游阶段通过后方可执行。下表列出了阶段间的依赖关系与阻断条件：

3.6 流水线阶段的最佳实践

1. 阶段原子化：每个阶段只做一件事，避免将多个职责混合在一个阶段中。例如，构建阶段只负责编译和打包，不执行测试。
2. 质量门禁前置：将成本低、反馈快的检查（如代码风格、单元测试）放在流水线早期，将成本高、反馈慢的检查（如E2E测试、安全扫描）放在后期。
3. 并行化执行：对于无依赖关系的阶段（如单元测试与静态分析），应并行执行以缩短流水线总时长。
4. SLI标准化：所有阶段使用统一的SLI命名规范，例如 pipeline_stage_duration_seconds、pipeline_stage_success_total，便于全局聚合分析。
5. 失败快速反馈：阶段失败后立即通知开发者，并提供详细的失败日志与上下文信息，减少排查时间。

3.7 阶段划分的常见误区