Linux 与服务器运维 / 系统课时
验证健康状态并执行回滚
验证健康状态并执行回滚
发布完成后不能只看“进程还在”。这一节把验证拆成进程、端口、HTTP、日志和核心业务请求五层,并用 current/previous 版本指针保留可逆路径;任一关键检查失败,就能快速切回上一已知可用版本并重新验收。
学习目标
- 按从底层到业务层的顺序验证发布后的真实健康状态。
- 用不可变版本目录和原子符号链接切换保留上一版本。
- 在健康检查失败时执行回滚,并识别数据库变更等不能靠二进制回滚解决的边界。
先把发布目录设计成可回滚
应用文件不要直接覆盖生产目录。每次发布创建独立版本目录,current 指向当前运行版本,previous 指向上一个已验证版本。这样回滚本质上是切换指针,而不是临时寻找旧包。
| 路径 | 作用 |
|---|---|
/opt/myapp/releases/<ID> |
某次不可变发布产物 |
/opt/myapp/current |
当前运行版本的符号链接 |
/opt/myapp/previous |
上一已知可用版本的符号链接 |
下面示例假设 systemd 服务名为 myapp,且服务从 /opt/myapp/current 启动。执行前把 <ID> 替换为本次发布标识。
APP_ROOT="/opt/myapp"
SERVICE="myapp"
NEW_RELEASE="$APP_ROOT/releases/<ID>"
OLD_RELEASE="$(readlink -f "$APP_ROOT/current")"
test -x "$NEW_RELEASE/bin/myapp"
sudo ln -sfn "$NEW_RELEASE" "$APP_ROOT/current.next"
sudo mv -Tf "$APP_ROOT/current.next" "$APP_ROOT/current"
sudo ln -sfn "$OLD_RELEASE" "$APP_ROOT/previous"
sudo systemctl restart "$SERVICE"
sudo systemctl is-active "$SERVICE"
readlink -f "$APP_ROOT/current"预期输出
active
/opt/myapp/releases/<ID>mv -T 在同一文件系统内替换符号链接时是原子操作,客户端不会看到一个“半切换”的 current。但 active 只说明 systemd 认为进程存活,还不能证明应用已经可用。
按五层健康状态逐级验收
推荐按进程、监听端口、HTTP 健康接口、近期错误日志、核心业务请求的顺序检查。前一层失败时先修复该层,不要跳到更高层猜测业务问题。下面给出一个完整主示例;执行前把 <PORT> 以及两个 URL 改成真实值。
sudo install -m 0755 /dev/stdin /usr/local/sbin/myapp-health-check <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
SERVICE="${SERVICE:-myapp}"
PORT="${PORT:-<PORT>}"
HEALTH_URL="${HEALTH_URL:-http://127.0.0.1:<PORT>/health}"
BUSINESS_URL="${BUSINESS_URL:-http://127.0.0.1:<PORT>/api/ping}"
systemctl is-active --quiet "$SERVICE"
ss -lntH "sport = :${PORT}" | grep -q LISTEN
curl -fsS "$HEALTH_URL" >/dev/null
if journalctl -u "$SERVICE" --since '-5 min' --no-pager | grep -Eqi 'panic|fatal|uncaught exception'; then
echo "fatal log found" >&2
exit 1
fi
curl -fsS "$BUSINESS_URL" | grep -q '"ok":true'
echo "health check passed"
EOF
sudo env SERVICE="myapp" PORT="<PORT>" HEALTH_URL="http://127.0.0.1:<PORT>/health" BUSINESS_URL="http://127.0.0.1:<PORT>/api/ping" /usr/local/sbin/myapp-health-check预期输出
health check passed健康路径和业务断言必须与真实服务契约一致。/health 适合检查依赖和就绪状态,核心业务请求则应选择一个安全、低副作用、能覆盖关键链路的只读接口;不要用“首页返回 200”替代业务验收。脚本任一检查失败都会以非零状态退出,发布流程应据此停止继续放量。
让失败自动进入回滚路径
发布前必须确认 previous 指向最近一次已验证版本,而不是“上一次上传的文件”。一旦五层检查任一关键项失败,先保存异常证据,再切回 previous,重启服务并重新执行同一套健康检查。
APP_ROOT="/opt/myapp"
SERVICE="myapp"
ROLLBACK_RELEASE="$(readlink -f "$APP_ROOT/previous")"
test -d "$ROLLBACK_RELEASE"
sudo ln -sfn "$ROLLBACK_RELEASE" "$APP_ROOT/current.rollback"
sudo mv -Tf "$APP_ROOT/current.rollback" "$APP_ROOT/current"
sudo systemctl restart "$SERVICE"
sudo systemctl is-active "$SERVICE"
readlink -f "$APP_ROOT/current"
sudo /usr/local/sbin/myapp-health-check预期输出
active
/opt/myapp/releases/<ID>
health check passed这里的 <ID> 是上一已知可用版本的实际发布标识。回滚后仍然必须完整复验;“切回旧版本”只是动作,不是恢复成功的证据。

明确回滚不能解决的边界
二进制和静态配置可以通过版本目录快速回退,但数据库结构、消息格式和外部副作用可能已经改变。若新版本执行了不向后兼容的 DROP COLUMN、不可逆数据迁移或向外部系统写入新格式,旧程序即使重新启动也可能无法工作。
因此发布设计要把“可回滚”前置到变更方案中:数据库优先采用先扩展、双版本兼容、再收缩的迁移方式;配置变更要保留版本或备份;不可逆操作需要单独的恢复方案。最终验收标准不是“回滚命令执行成功”,而是上一版本恢复后五层健康检查再次全部通过,并且核心业务请求得到预期结果。