CI/CD / 系统课时

典型交付流程设计

典型交付流程设计

典型 CI/CD 流程要解决的不是“把部署做快”,而是让每次代码变更依次经过检查、测试、构建、发布和验证,并在失败时停止扩散或执行回滚。合理的链路应该让错误尽可能早暴露,同时保证发布制品可以追踪和恢复。

学习目标

  • 能设计从代码提交到生产验证的标准交付链路
  • 理解质量门禁、制品不可变和环境晋级的作用
  • 能为发布失败设计明确的停止与回滚路径

从提交开始建立质量门禁

代码提交后不应立即进入部署。流水线首先执行成本较低、反馈较快的检查,例如格式校验、静态分析和基础安全检查;这些步骤失败时直接终止运行,避免继续消耗测试和构建资源。

随后进入自动化测试。单元测试通常最先运行,集成测试和端到端测试可以根据项目成本安排在后续阶段。设计重点不是测试名称,而是为每个阶段定义明确的通过条件:退出码异常、测试失败或关键质量指标不满足,都必须阻止后续发布。

构建一次并逐级晋级

检查和测试通过后,流水线生成一个具有唯一版本标识的制品,例如应用包或容器镜像。推荐的原则是构建一次,多环境复用:预发布和生产环境使用同一份已经验证的制品,只替换环境配置和凭据。

这样可以避免在不同环境重复构建产生差异,也能把一次发布准确关联到源码提交、流水线运行和制品版本。制品版本可以使用提交哈希、版本标签或流水线运行 ID,但必须能够唯一追踪。

代码提交到发布验证与回滚的标准交付链路

把关键步骤写成可失败的任务

流水线中的每个质量门禁都应该由进程退出状态明确表达结果,而不是只打印一段日志后继续执行。下面以一个已经定义 lint、test 和 build 脚本的 Node.js 项目为例,展示本地可复现的最小质量链。

bash
#!/usr/bin/env bash
set -euo pipefail

npm ci
npm run lint
npm test
npm run build

echo "quality gates passed"

预期结果

text
依赖安装、静态检查、测试和构建均成功时,最后输出:
quality gates passed
任一步骤返回非 0 退出码时,脚本立即停止,后续步骤不会执行。

实际项目的测试日志和构建输出会随工具版本不同而变化,但退出状态必须稳定地反映成功或失败。CI 平台据此决定任务状态,并进一步控制后续阶段是否允许启动。

发布后必须验证真实运行状态

部署命令执行成功并不等于发布成功。新版本启动后,还需要检查应用是否真正可用,例如健康检查是否通过、关键接口是否返回正常、错误率和延迟是否异常,以及新实例是否持续存活。

预发布环境主要用于提前暴露配置、依赖和兼容性问题;生产验证则关注真实流量下的运行质量。对于重要服务,可以采用分批发布或灰度发布,让少量实例先承载流量,通过观察窗口后再扩大范围。

为失败预先设计停止和回滚

标准流程必须在发布前确定失败后的动作。检查和测试阶段失败时通常只需要停止流水线;预发布验证失败时停止环境晋级;生产验证失败时,则应根据风险立即停止扩容,并恢复上一份已经确认稳定的制品。

回滚最好复用历史制品,而不是临时从旧源码重新构建。这样可以缩短恢复路径,并确保恢复版本就是此前真正运行过的版本。数据库结构变更、不可逆数据迁移等操作还需要单独设计兼容窗口,因为应用制品回滚并不能自动撤销数据变化。

一条成熟的交付链最终应形成清晰的闭环:代码变更先经过快速门禁,再生成唯一制品;同一制品逐级晋级到不同环境;每次部署之后进行真实验证;任何阶段失败都有明确的停止点,而生产故障能够回到已知稳定版本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

典型交付流程设计

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通