CI/CD / 系统课时
实现版本快速回滚
实现版本快速回滚
部署失败时,最快的恢复方式不是临时修代码,而是把线上流量切回已经验证过的稳定版本。本节用“版本目录 + current 符号链接”实现秒级回滚,并补充制品重部署方案与验收检查。
学习目标
- 设计可回滚的服务器版本目录与保留策略
- 使用原子链接切换完成发布与回滚
- 验证回滚后的进程、版本与健康状态
设计可回滚的发布目录
不要把新版本直接覆盖到同一个应用目录,否则旧文件一旦被替换,回滚就只能重新下载制品。更稳妥的做法是让每次发布进入独立目录,再让固定入口 current 指向当前生效版本。

目录可以约定为 /srv/myapp/releases/<ID>,其中 <ID> 使用构建号、Git 提交号或发布时间生成。生产环境至少保留最近几个已验证版本,并确保配置、密钥和持久化数据不写入版本目录。
发布时创建新版本并切换
下面脚本把新的 JAR 放进独立目录,先完成文件准备,再通过 ln -sfn 更新临时链接,最后用 mv -Tf 原子替换 current。示例假设 systemd 服务名为 myapp。
set -euo pipefail
APP_ROOT=/srv/myapp
RELEASE_ID="<ID>"
ARTIFACT="<PATH>/app.jar"
RELEASE_DIR="$APP_ROOT/releases/$RELEASE_ID"
mkdir -p "$RELEASE_DIR"
install -m 0644 "$ARTIFACT" "$RELEASE_DIR/app.jar"
ln -sfn "$RELEASE_DIR" "$APP_ROOT/current.next"
mv -Tf "$APP_ROOT/current.next" "$APP_ROOT/current"
systemctl restart myapp
readlink -f "$APP_ROOT/current"
systemctl is-active myapp预期输出
/srv/myapp/releases/<ID>
active实际版本号与制品路径会不同。关键点是:只有制品准备完成后才切换入口,避免 current 指向一个尚未完整写入的目录。
回滚到上一个稳定版本
回滚时不要重新构建旧代码,而应直接选择已存在且经过验证的版本目录。先确认目标目录存在,再切换链接并重启服务。
set -euo pipefail
APP_ROOT=/srv/myapp
ROLLBACK_ID="<ID>"
TARGET="$APP_ROOT/releases/$ROLLBACK_ID"
test -f "$TARGET/app.jar"
ln -sfn "$TARGET" "$APP_ROOT/current.next"
mv -Tf "$APP_ROOT/current.next" "$APP_ROOT/current"
systemctl restart myapp
readlink -f "$APP_ROOT/current"
systemctl is-active myapp预期输出
/srv/myapp/releases/<ID>
active如果发布平台不允许直接操作服务器目录,也可以采用“按版本号重新部署旧制品”的模式。此时必须确保制品仓库保存不可变版本,回滚动作只是重新选择旧版本,而不是重新执行一次可能产生不同结果的构建。
验证回滚是否真正成功
“进程是 active”只能证明服务启动了,不能证明业务已经恢复。回滚完成后至少检查三个层次:current 是否指向目标版本、应用暴露的版本信息是否一致、健康检查与核心请求是否恢复。
readlink -f /srv/myapp/current
curl -fsS http://127.0.0.1:<PORT>/version
curl -fsS http://127.0.0.1:<PORT>/health预期输出
/srv/myapp/releases/<ID>
{"version":"<ID>"}
{"status":"UP"}接口字段应以实际应用为准;如果没有版本接口,至少把构建号写入启动日志或静态文件,保证回滚后能确认当前运行的究竟是哪一版。
保留版本与清理策略
版本目录不应无限增长,也不能只保留“上一版”。常见策略是保留最近 5~10 个成功版本,同时额外保护最近一次人工确认的稳定版本。清理前必须排除 current 当前指向目录,并优先按“已成功部署时间”而不是文件修改时间排序。
回滚能力真正依赖的是不可变制品、可定位版本、原子切换和可验证结果。只要这四点成立,发布失败就能从“重新修复后再上线”变成“先恢复稳定服务,再处理缺陷”。