平滑滚动升级重启需确保“不中断服务”+“可回退”+“状态可控”,通过干净拉取、版本隔离、流量切换、备份回滚及多层校验实现。

自动拉取 Git 代码并完成平滑滚动升级重启,核心在于“不中断服务”+“可回退”+“状态可控”。不是简单 git pull 后 kill 再 start,而是通过进程管理、版本隔离和流量切换来实现真正平滑。
一、先确保仓库干净再拉取
避免未提交修改导致 pull 失败或覆盖本地变更:
- 用 git status --porcelain 检查工作区和暂存区是否干净,有输出就中止脚本(或加 -f 强制重置)
- 执行 git fetch origin master && git reset --hard origin/master 替代 git pull,更可控,避免 merge 提交污染历史
- 建议加上 set -e,任一命令失败立即退出,防止后续步骤误执行
二、构建/打包前做版本隔离
新旧版本不能共用同一目录或 jar 文件,否则重启时可能加载错误字节码:
- 用时间戳或 commit hash 命名构建产物,例如:app-$(git rev-parse --short HEAD)-$(date +%s).jar
- Java 项目:mvn clean package -Dmaven.test.skip=true -Dmaven.build.timestamp=xxx,输出到独立 target 目录
- 前端项目:npm run build 输出到 dist-$(git rev-parse --short HEAD),再用软链接指向当前生效的 dist
三、滚动重启靠进程管理与流量摘除
单机多实例或集群场景下,滚动重启本质是“逐个下线 → 更新 → 上线”,关键在控制流量:
- 若用 systemd:先 systemctl kill -s SIGUSR2 myapp.service(通知应用优雅停机),再 systemctl restart myapp;配合 ExecReload= 指令可定制 reload 行为
- 若用 nohup 或自管进程:先用 curl -X POST http://localhost:8080/actuator/health 确认健康,再调用 /actuator/pause(Spring Boot)暂停流量,等连接空闲后 kill 进程,启动新实例,最后调 /actuator/resume
- 前置 Nginx 或 LB 场景:脚本中执行 ssh web1 "echo 'down' > /etc/nginx/conf.d/myapp.down" 摘除节点,reload nginx,更新完再删 down 文件并 reload
四、日志、备份与回滚准备不能少
上线不是终点,出问题要能 30 秒内切回上一版:
- 每次部署前,自动备份当前运行 jar 和 config 目录,例如:cp app.jar app.jar.$(date +%s) && cp -r config/ config.$(date +%s)
- 记录部署信息到文件:echo "$(date): $(git rev-parse HEAD) -> $(pwd)/app.jar" >> /var/log/deploy-history.log
- 提供一键回滚函数:读取上一条记录中的 commit hash,git reset --hard 那个版本,重新打包启动
不复杂但容易忽略的是状态校验和人工确认点。比如拉取后检查 pom.xml 版本号是否变更、构建后验证 jar MANIFEST.MF 中的 Build-Time 字段、重启后 curl 接口返回 200 并含预期文本——这些才是平滑升级真正落地的保障。











