容器升级与回滚流程
升级不是 pull 一下就完事:先备份、再观察、留退路。
容器升级看起来很简单,实际风险集中在数据格式和依赖版本。流程固定下来,能把大部分问题挡在前面。
升级前
- 记录当前镜像 tag:
docker compose images; - 备份数据卷或做数据库导出;
- 确认新版本是否要求数据迁移、是否有破坏性变更;
- 保留旧镜像,别急着
image prune。
升级
bash
docker compose pull app
docker compose up -d app
docker compose ps
docker compose logs --tail=100 appup -d 会重建容器,数据卷保留。观察启动日志和健康检查,确认没有反复重启。
回滚
把 compose 里的 tag 改回旧版本,再 up -d。前置条件是数据格式仍兼容;如果新版本已经迁移了数据库结构,回滚可能失败,这也是升级前必须看变更说明的原因。
yaml
services:
app:
image: example/app:1.2.3 # 回滚时改回旧 tag自动更新的风险
Watchtower 一类工具会定期拉取并重建容器,适合无状态服务,不适合数据库和需要人工确认的组件。半夜自动升级把服务升挂,比手动升级麻烦得多。
latest 不是版本
latest 会随时间指向不同镜像,同一份 compose 在不同时间部署出不同结果。生产环境锁到具体版本号或 digest。
升级后的检查
- 健康检查通过;
- 关键接口返回正常;
- 日志无异常堆栈;
- 资源占用没有明显上升;
- 数据可读写(不只是能打开页面)。
小结
备份、锁版本、观察、留旧镜像。四步做完,升级就不再是碰运气。
说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2026-06-28。