CI/CD / 系统课时
模拟发布失败并执行回滚
模拟发布失败并执行回滚
生产链路只有在失败时也能安全退出才算完整。本节用可控的健康检查失败模拟一次坏版本发布,让工作流检测异常、停止继续交付并执行回滚,再通过第二次健康检查确认旧版本已经恢复服务。
学习目标
- 在部署后使用健康检查决定发布是否成功
- 用可控故障验证失败分支确实能够触发
- 在失败后回滚到已知稳定版本并再次验证服务
把失败检测放进发布链路
部署命令成功只代表操作执行完成,不代表应用已经可用。生产流水线通常还需要访问健康检查端点;如果新版本无法启动、依赖不可用或返回异常状态,工作流应把本次发布判为失败并进入回滚。

关键点是预先知道“回到哪个版本”。稳定版本可以由部署平台的 release ID、镜像不可变标签或镜像 digest 表示,而不是临时猜测上一条 Git 提交。
用可控故障验证回滚
下面是一个可直接运行的 Bash 演示。它不修改真实生产环境,而是用文件保存当前版本,并故意让 v2 健康检查失败,从而验证检测与回滚控制流。
set -euo pipefail
STABLE_VERSION="v1"
NEW_VERSION="v2"
STATE_FILE="${RUNNER_TEMP:-/tmp}/deployed-version"
deploy() {
printf '%s' "$1" > "$STATE_FILE"
echo "Deployed $1"
}
health_check() {
local version
version="$(cat "$STATE_FILE")"
# 故意把 v2 视为故障版本,用于验证失败分支。
test "$version" != "v2"
}
deploy "$STABLE_VERSION"
deploy "$NEW_VERSION"
if health_check; then
echo "Release healthy"
else
echo "Health check failed; rolling back"
deploy "$STABLE_VERSION"
health_check
echo "Rollback verified"
fi预期输出
Deployed v1
Deployed v2
Health check failed; rolling back
Deployed v1
Rollback verified在真实 GitHub Actions 中,可以把同样的控制流放进部署脚本,或者把回滚设计成独立步骤。不要用 continue-on-error: true 简单吞掉健康检查失败,否则后续步骤可能把失败发布误判为成功。
在工作流中保留失败语义
如果回滚步骤必须在前面的部署或检查失败后运行,可以使用步骤条件。下面是片段示例,依赖同一 Job 中已经存在的 deploy 和 health 步骤,以及项目提供的 scripts/rollback.sh。
- name: Roll back production
if: ${{ failure() }}
shell: bash
run: ./scripts/rollback.sh "$STABLE_VERSION"生效行为是:此前步骤使 Job 进入失败状态后,该步骤仍会执行。验证时应确认回滚脚本恢复的是预先记录的稳定版本,而不是未经验证的新构建。
验收失败链路
一次有效的演练至少要证明三个事实:坏版本确实触发健康检查失败;失败后确实选择了预定稳定版本;回滚完成后再次检查能够通过。还应保留失败版本、稳定版本和运行记录,便于定位发布事故。
故障演练的目标不是制造一个红色 Workflow,而是证明发布系统面对坏版本时具有确定的停止点、回退目标和恢复验证。只有这条失败路径被实际执行过,回滚方案才不是停留在文档里的假设。