CI/CD / 系统课时
典型交付流程设计
典型交付流程设计
典型 CI/CD 流程要解决的不是“把部署做快”,而是让每次代码变更依次经过检查、测试、构建、发布和验证,并在失败时停止扩散或执行回滚。合理的链路应该让错误尽可能早暴露,同时保证发布制品可以追踪和恢复。
学习目标
- 能设计从代码提交到生产验证的标准交付链路
- 理解质量门禁、制品不可变和环境晋级的作用
- 能为发布失败设计明确的停止与回滚路径
从提交开始建立质量门禁
代码提交后不应立即进入部署。流水线首先执行成本较低、反馈较快的检查,例如格式校验、静态分析和基础安全检查;这些步骤失败时直接终止运行,避免继续消耗测试和构建资源。
随后进入自动化测试。单元测试通常最先运行,集成测试和端到端测试可以根据项目成本安排在后续阶段。设计重点不是测试名称,而是为每个阶段定义明确的通过条件:退出码异常、测试失败或关键质量指标不满足,都必须阻止后续发布。
构建一次并逐级晋级
检查和测试通过后,流水线生成一个具有唯一版本标识的制品,例如应用包或容器镜像。推荐的原则是构建一次,多环境复用:预发布和生产环境使用同一份已经验证的制品,只替换环境配置和凭据。
这样可以避免在不同环境重复构建产生差异,也能把一次发布准确关联到源码提交、流水线运行和制品版本。制品版本可以使用提交哈希、版本标签或流水线运行 ID,但必须能够唯一追踪。

把关键步骤写成可失败的任务
流水线中的每个质量门禁都应该由进程退出状态明确表达结果,而不是只打印一段日志后继续执行。下面以一个已经定义 lint、test 和 build 脚本的 Node.js 项目为例,展示本地可复现的最小质量链。
#!/usr/bin/env bash
set -euo pipefail
npm ci
npm run lint
npm test
npm run build
echo "quality gates passed"预期结果
依赖安装、静态检查、测试和构建均成功时,最后输出:
quality gates passed
任一步骤返回非 0 退出码时,脚本立即停止,后续步骤不会执行。实际项目的测试日志和构建输出会随工具版本不同而变化,但退出状态必须稳定地反映成功或失败。CI 平台据此决定任务状态,并进一步控制后续阶段是否允许启动。
发布后必须验证真实运行状态
部署命令执行成功并不等于发布成功。新版本启动后,还需要检查应用是否真正可用,例如健康检查是否通过、关键接口是否返回正常、错误率和延迟是否异常,以及新实例是否持续存活。
预发布环境主要用于提前暴露配置、依赖和兼容性问题;生产验证则关注真实流量下的运行质量。对于重要服务,可以采用分批发布或灰度发布,让少量实例先承载流量,通过观察窗口后再扩大范围。
为失败预先设计停止和回滚
标准流程必须在发布前确定失败后的动作。检查和测试阶段失败时通常只需要停止流水线;预发布验证失败时停止环境晋级;生产验证失败时,则应根据风险立即停止扩容,并恢复上一份已经确认稳定的制品。
回滚最好复用历史制品,而不是临时从旧源码重新构建。这样可以缩短恢复路径,并确保恢复版本就是此前真正运行过的版本。数据库结构变更、不可逆数据迁移等操作还需要单独设计兼容窗口,因为应用制品回滚并不能自动撤销数据变化。
一条成熟的交付链最终应形成清晰的闭环:代码变更先经过快速门禁,再生成唯一制品;同一制品逐级晋级到不同环境;每次部署之后进行真实验证;任何阶段失败都有明确的停止点,而生产故障能够回到已知稳定版本。