容器与云原生 / 系统课时

部署失败怎样回到旧镜像

部署失败怎样回到旧镜像

新版本启动失败、健康检查异常或关键接口报错时,最直接的止损方式是把服务镜像指回上一稳定版本,再让 Compose 重新创建该服务容器。本篇完成一次可验证的基础回滚,并说明哪些数据问题不能靠换镜像解决。

学习目标

  • 能把 Compose 服务恢复到已知稳定的镜像标签
  • 能只重建目标服务并确认实际运行镜像
  • 能识别数据库迁移、卷数据等不能随镜像自动回滚的风险

回滚的核心是重新声明期望版本

Compose 不保存“发布历史”,也不会自动知道哪个镜像是上一稳定版本。可靠做法是在发布系统、镜像仓库或变更记录中保留可追溯的版本号或 digest,失败时把 image 恢复到已验证版本,再执行重建。

下面是片段示例,假设服务名为 app,镜像版本由环境变量控制:

yaml
services:
  app:
    image: ${APP_IMAGE}
    restart: unless-stopped

把稳定版本写成不可混淆的标签,例如 ghcr.io/example/shop-api:1.7.3。生产环境不要依赖会移动的 latest,否则“回滚到旧版本”可能仍拉到不同内容。

拉取旧镜像并重建目标服务

在包含 compose.yaml 的目录执行以下命令。--no-deps 表示只处理 app,避免无必要地重建数据库、缓存等依赖服务。

bash
export APP_IMAGE=ghcr.io/example/shop-api:1.7.3
docker compose pull app
docker compose up -d --no-deps app >/dev/null 2>&1
docker inspect -f '{{.Config.Image}}' $(docker compose ps -q app)

预期输出

text
ghcr.io/example/shop-api:1.7.3

这说明当前容器配置已经引用旧镜像。若 pull 失败,应先确认标签确实存在、仓库登录状态正确,并避免继续用本地不确定的缓存镜像顶替。

验证的不只是镜像版本

镜像正确并不代表业务已经恢复。至少还应检查服务是否持续运行、健康检查是否通过,以及本次失败涉及的关键接口或任务能否正常工作。若服务在启动后反复退出,先看 docker compose logs app,不要连续重建掩盖真实错误。

把回滚做成可重复操作

基础回滚的关键不是记住某条命令,而是确保每次发布都能回答两个问题:上一稳定镜像的精确标识是什么,以及恢复后用什么业务检查判定成功。只要版本可追溯、镜像仍可获取、数据兼容,Compose 就能用“改回旧镜像并重新创建容器”的方式完成快速止损。

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

目录与阅读设置

阅读设置

17

记录一个想法

部署失败怎样回到旧镜像

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

登录哪都通