容器与云原生 / 系统课时

执行一次应用版本升级和回滚

执行一次应用版本升级和回滚

应用升级不能只验证“新容器启动过”,还要保留明确的上一稳定版本,并能在候选版本失败时快速回切。本节用两个本地镜像标签模拟发布:先运行 1.0.0,再切换到故意损坏的 2.0.0,通过状态和日志确认失败后回滚。

学习目标

  • 用镜像标签把当前版本和上一稳定版本显式记录在 Compose 配置之外。
  • 只重新创建目标服务,验证升级后的容器状态与页面结果。
  • 在失败发布后恢复旧标签,并理解应用回滚与数据回滚的边界。

准备可切换版本的镜像

先创建 Dockerfile。BROKEN=true 时写入一条无效的 Nginx 指令,使候选版本容器启动即退出;正常版本则返回自己的版本号。

dockerfile
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; \
    fi

Compose 文件只通过 APP_TAG 选择镜像版本。这样升级和回滚都只需要切换一个明确的版本值,而不是依赖可变的 latest 标签。

yaml
services:
  web:
    image: "demo-web:${APP_TAG:-1.0.0}"
    ports:
      - "8080:80"

这两个配置片段的生效验证方式是运行 docker compose config --images,确认最终解析出的镜像标签与准备发布的版本一致。

完成升级失败与回滚演练

下面的主示例先构建稳定镜像和故障镜像,再依次完成基线启动、候选发布、失败确认和回滚。--no-deps 表示只处理 web,不会顺带重新创建它依赖的其他服务;真实项目仍应在发布前确认新版本是否需要配套依赖或迁移。

bash
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

预期输出

text
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 不会自动撤销已经执行的数据迁移,也不应该通过删除卷来“恢复版本”。如果发布包含数据库结构变化,应优先设计向前、向后兼容的迁移,并把迁移步骤和应用回滚策略一起演练。

实际部署还应记录成功验收过的不可变标签或镜像摘要,并在切换版本前确认解析结果。升级后的最低验收至少包括容器处于运行状态、关键日志无启动错误、核心接口或页面可用;任一关键检查失败,就按预先保存的稳定版本值回切,而不是现场猜测应该退到哪个镜像。

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

目录与阅读设置

阅读设置

17

记录一个想法

执行一次应用版本升级和回滚

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

登录哪都通