React / 系统课时
发布流程与后续演进
发布流程与后续演进
本课把前端构建、后端测试、数据库迁移、服务切换、健康检查和回滚整理为一条可重复的发布链路,并给出缓存、消息队列与持续集成的演进优先级,避免发布依赖个人经验。
学习目标
- 建立可检查、可停止、可回滚的标准发布流程
- 理解应用回滚与数据库迁移之间的兼容边界
- 按业务瓶颈规划缓存、消息队列和持续集成
定义发布的最小闭环
一次完整发布至少包含代码确认、依赖安装、自动化测试、前后端构建、数据库迁移、产物部署、服务重启、健康检查和观察期。任何一步失败,都应停止后续动作并保留日志。

发布前必须能回答三个问题:本次部署的唯一版本号是什么,失败后切回哪个版本,数据库变更是否兼容新旧两版应用。没有明确答案时,不应直接操作生产环境。
执行可重复的发布脚本
下面示例采用版本目录加 current 软链接的方式部署。它假设项目包含 frontend 与 server 两个目录,二者都定义了 test 和 build 脚本,后端额外定义 migrate:deploy,生产服务名为 fullstack-app。路径和服务名应按实际环境调整。
#!/usr/bin/env bash
set -euo pipefail
VERSION="${1:?用法: ./release.sh <VERSION>}"
APP_ROOT="/opt/fullstack-app"
RELEASE_DIR="$APP_ROOT/releases/$VERSION"
CURRENT_LINK="$APP_ROOT/current"
test ! -e "$RELEASE_DIR" || { echo "版本目录已存在: $RELEASE_DIR"; exit 1; }
npm --prefix frontend ci --silent
npm --prefix frontend test -- --run
npm --prefix frontend run build
npm --prefix server ci --silent
npm --prefix server test
npm --prefix server run build
npm --prefix server run migrate:deploy
mkdir -p "$RELEASE_DIR"
cp -a frontend/dist "$RELEASE_DIR/frontend"
cp -a server/dist server/package.json server/package-lock.json "$RELEASE_DIR/server"
npm --prefix "$RELEASE_DIR/server" ci --omit=dev --silent
ln -sfn "$RELEASE_DIR" "$CURRENT_LINK"
systemctl restart fullstack-app
curl -fsS "http://127.0.0.1:<PORT>/health" > /dev/null
echo "release $VERSION completed"预期输出
release <VERSION> completed脚本使用 set -euo pipefail,任一步返回非零状态都会停止发布。<PORT> 要替换为真实健康检查端口;测试框架、构建日志和耗时会因项目而异。
处理迁移与回滚边界
应用回滚通常只需把 current 软链接切回上一版本并重启服务,但数据库不能默认执行“向下迁移”。生产迁移应采用向前兼容策略:先新增字段或表,再发布同时兼容新旧结构的应用,最后在确认旧版本不再使用后删除废弃结构。
发布后若健康检查失败,应立即停止流量扩大,保留失败版本和日志,然后切回上一应用版本。若迁移已经改变数据语义,必须按预先设计的数据修复方案处理,不能临时执行不可逆 SQL。
建立发布验收清单
健康检查只证明进程能响应,还要验证登录、核心查询、写入和静态资源加载。发布后观察一段时间内的错误率、接口延迟、CPU、内存、数据库连接数和关键业务成功率,确认没有缓慢恶化。
每次发布应保存版本号、提交哈希、构建时间、迁移编号、操作者、开始与结束时间,以及回滚目标。这样出现问题时,团队可以快速回答“线上运行的究竟是哪一版”。
规划后续演进顺序
缓存适合解决高频读取和重复计算,但必须先明确失效策略、数据一致性和穿透保护。消息队列适合把耗时或可重试任务异步化,例如通知、审计和报表生成,但要同时设计幂等、重试和死信处理。
持续集成应优先落地,因为它能自动执行格式检查、测试和构建,阻止不合格版本进入发布阶段。随后再增加制品仓库、自动部署、灰度发布和指标告警。不要在基础测试与回滚都不稳定时,直接追求复杂的自动扩缩容。