CI/CD / 系统课时

实现版本快速回滚

实现版本快速回滚

部署失败时,最快的恢复方式不是临时修代码,而是把线上流量切回已经验证过的稳定版本。本节用“版本目录 + current 符号链接”实现秒级回滚,并补充制品重部署方案与验收检查。

学习目标

  • 设计可回滚的服务器版本目录与保留策略
  • 使用原子链接切换完成发布与回滚
  • 验证回滚后的进程、版本与健康状态

设计可回滚的发布目录

不要把新版本直接覆盖到同一个应用目录,否则旧文件一旦被替换,回滚就只能重新下载制品。更稳妥的做法是让每次发布进入独立目录,再让固定入口 current 指向当前生效版本。

版本目录与 current 链接切换关系

目录可以约定为 /srv/myapp/releases/<ID>,其中 <ID> 使用构建号、Git 提交号或发布时间生成。生产环境至少保留最近几个已验证版本,并确保配置、密钥和持久化数据不写入版本目录。

发布时创建新版本并切换

下面脚本把新的 JAR 放进独立目录,先完成文件准备,再通过 ln -sfn 更新临时链接,最后用 mv -Tf 原子替换 current。示例假设 systemd 服务名为 myapp。

bash
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

预期输出

text
/srv/myapp/releases/<ID>
active

实际版本号与制品路径会不同。关键点是:只有制品准备完成后才切换入口,避免 current 指向一个尚未完整写入的目录。

回滚到上一个稳定版本

回滚时不要重新构建旧代码,而应直接选择已存在且经过验证的版本目录。先确认目标目录存在,再切换链接并重启服务。

bash
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

预期输出

text
/srv/myapp/releases/<ID>
active

如果发布平台不允许直接操作服务器目录,也可以采用“按版本号重新部署旧制品”的模式。此时必须确保制品仓库保存不可变版本,回滚动作只是重新选择旧版本,而不是重新执行一次可能产生不同结果的构建。

验证回滚是否真正成功

“进程是 active”只能证明服务启动了,不能证明业务已经恢复。回滚完成后至少检查三个层次:current 是否指向目标版本、应用暴露的版本信息是否一致、健康检查与核心请求是否恢复。

bash
readlink -f /srv/myapp/current
curl -fsS http://127.0.0.1:<PORT>/version
curl -fsS http://127.0.0.1:<PORT>/health

预期输出

text
/srv/myapp/releases/<ID>
{"version":"<ID>"}
{"status":"UP"}

接口字段应以实际应用为准;如果没有版本接口,至少把构建号写入启动日志或静态文件,保证回滚后能确认当前运行的究竟是哪一版。

保留版本与清理策略

版本目录不应无限增长,也不能只保留“上一版”。常见策略是保留最近 5~10 个成功版本,同时额外保护最近一次人工确认的稳定版本。清理前必须排除 current 当前指向目录,并优先按“已成功部署时间”而不是文件修改时间排序。

回滚能力真正依赖的是不可变制品、可定位版本、原子切换和可验证结果。只要这四点成立,发布失败就能从“重新修复后再上线”变成“先恢复稳定服务,再处理缺陷”。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现版本快速回滚

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

登录哪都通