首页/容器/正文

容器升级与回滚流程

升级不是 pull 一下就完事:先备份、再观察、留退路。

容器容器与部署2026-06-28约 2 分钟388 字

容器升级看起来很简单,实际风险集中在数据格式和依赖版本。流程固定下来,能把大部分问题挡在前面。

升级前

  1. 记录当前镜像 tag:docker compose images;
  2. 备份数据卷或做数据库导出;
  3. 确认新版本是否要求数据迁移、是否有破坏性变更;
  4. 保留旧镜像,别急着 image prune。

升级

bash
docker compose pull app
docker compose up -d app
docker compose ps
docker compose logs --tail=100 app

up -d 会重建容器,数据卷保留。观察启动日志和健康检查,确认没有反复重启。

回滚

把 compose 里的 tag 改回旧版本,再 up -d。前置条件是数据格式仍兼容;如果新版本已经迁移了数据库结构,回滚可能失败,这也是升级前必须看变更说明的原因。

yaml
services:
  app:
    image: example/app:1.2.3   # 回滚时改回旧 tag

自动更新的风险

Watchtower 一类工具会定期拉取并重建容器,适合无状态服务,不适合数据库和需要人工确认的组件。半夜自动升级把服务升挂,比手动升级麻烦得多。

latest 不是版本

latest 会随时间指向不同镜像,同一份 compose 在不同时间部署出不同结果。生产环境锁到具体版本号或 digest。

升级后的检查

  • 健康检查通过;
  • 关键接口返回正常;
  • 日志无异常堆栈;
  • 资源占用没有明显上升;
  • 数据可读写(不只是能打开页面)。

小结

备份、锁版本、观察、留旧镜像。四步做完,升级就不再是碰运气。

说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2026-06-28。