容器与云原生 / 系统课时
部署失败怎样回到旧镜像
部署失败怎样回到旧镜像
新版本启动失败、健康检查异常或关键接口报错时,最直接的止损方式是把服务镜像指回上一稳定版本,再让 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 就能用“改回旧镜像并重新创建容器”的方式完成快速止损。
按自己的节奏,确认真正理解。