容器与云原生 / 系统课时
执行一次应用版本升级和回滚
执行一次应用版本升级和回滚
应用升级不能只验证“新容器启动过”,还要保留明确的上一稳定版本,并能在候选版本失败时快速回切。本节用两个本地镜像标签模拟发布:先运行 1.0.0,再切换到故意损坏的 2.0.0,通过状态和日志确认失败后回滚。
学习目标
- 用镜像标签把当前版本和上一稳定版本显式记录在 Compose 配置之外。
- 只重新创建目标服务,验证升级后的容器状态与页面结果。
- 在失败发布后恢复旧标签,并理解应用回滚与数据回滚的边界。
准备可切换版本的镜像
先创建 Dockerfile。BROKEN=true 时写入一条无效的 Nginx 指令,使候选版本容器启动即退出;正常版本则返回自己的版本号。
FROM nginx:alpine
ARG APP_VERSION=dev
ARG BROKEN=false
RUN if [ "$BROKEN" = "true" ]; then \
printf 'definitely_invalid_directive on;\n' > /etc/nginx/conf.d/default.conf; \
else \
printf '<!doctype html><html><body>version=%s</body></html>\n' "$APP_VERSION" > /usr/share/nginx/html/index.html; \
fiCompose 文件只通过 APP_TAG 选择镜像版本。这样升级和回滚都只需要切换一个明确的版本值,而不是依赖可变的 latest 标签。
services:
web:
image: "demo-web:${APP_TAG:-1.0.0}"
ports:
- "8080:80"这两个配置片段的生效验证方式是运行 docker compose config --images,确认最终解析出的镜像标签与准备发布的版本一致。
完成升级失败与回滚演练
下面的主示例先构建稳定镜像和故障镜像,再依次完成基线启动、候选发布、失败确认和回滚。--no-deps 表示只处理 web,不会顺带重新创建它依赖的其他服务;真实项目仍应在发布前确认新版本是否需要配套依赖或迁移。
docker build -q --build-arg APP_VERSION=1.0.0 --build-arg BROKEN=false -t demo-web:1.0.0 . >/dev/null
docker build -q --build-arg APP_VERSION=2.0.0 --build-arg BROKEN=true -t demo-web:2.0.0 . >/dev/null
printf 'APP_TAG=1.0.0\n' > .env
docker compose up -d >/dev/null
sleep 2
docker compose config --images
curl -fsS http://127.0.0.1:8080
printf 'APP_TAG=2.0.0\n' > .env
docker compose config --images
docker compose up -d --no-deps web >/dev/null || true
sleep 2
docker compose ps --all --status exited --services
docker compose logs --no-log-prefix --tail=2 web | tail -n 1
printf 'APP_TAG=1.0.0\n' > .env
docker compose up -d --no-deps web >/dev/null
sleep 2
docker compose ps --status running --services
curl -fsS http://127.0.0.1:8080预期输出
demo-web:1.0.0
<!doctype html><html><body>version=1.0.0</body></html>
demo-web:2.0.0
web
nginx: [emerg] unknown directive "definitely_invalid_directive" in /etc/nginx/conf.d/default.conf:1
web
<!doctype html><html><body>version=1.0.0</body></html>候选版本失败时,不要先覆盖旧镜像标签或删除旧镜像。先保留故障现场,通过 docker compose ps --all 确认容器退出,再看服务日志确认启动错误。回滚时把 APP_TAG 恢复到已验证的旧值,再执行一次 docker compose up -d --no-deps web,Compose 会按旧镜像重新创建该服务。

把回滚边界说清
这套方法回滚的是 应用镜像和容器配置,不是数据库内容。重新创建 web 不会自动撤销已经执行的数据迁移,也不应该通过删除卷来“恢复版本”。如果发布包含数据库结构变化,应优先设计向前、向后兼容的迁移,并把迁移步骤和应用回滚策略一起演练。
实际部署还应记录成功验收过的不可变标签或镜像摘要,并在切换版本前确认解析结果。升级后的最低验收至少包括容器处于运行状态、关键日志无启动错误、核心接口或页面可用;任一关键检查失败,就按预先保存的稳定版本值回切,而不是现场猜测应该退到哪个镜像。