Compose 升级前，先确认你将运行哪个镜像

> 日期说明：归档日期为历史整理日期，不代表原始首发时间；本文于 2026-11-02 核对并修订。命令示例需按实际环境替换占位符。


latest 是可变化的标签，也可能指向本地旧缓存。本文整理两个容易忽略的环节，作为日常使用时的检查参考。

<!-- more -->

## 标签不是固定版本

latest 是可变化的标签，也可能指向本地旧缓存。更新部署文件或重建容器，并不必然下载新镜像。需要先 pull，再核对版本或 digest，并记录升级前实际使用的镜像。

## 应用与数据要分别回滚

保留旧镜像只能回退程序。新版本如果升级了数据库结构，旧程序可能无法读取数据。因此升级前应阅读迁移说明，并建立一致性备份。重要应用可以先在隔离环境测试恢复。

## 日常使用的小结

一次只升级一个关键组件，确认健康检查与真实业务请求后再继续。不要把镜像清理和版本升级同时进行，免得刚升级就失去回退机会。


## 操作参考与适用边界

### 升级前记录与拉取

```sh
docker compose images
docker compose config --quiet
docker compose pull SERVICE
```

这组命令不包含应用重建。pull 会下载镜像并更新本地标签；确认备份、迁移说明和镜像版本后，才执行实际更新。镜像更新不等同于数据库能够回滚。

### 如何判断结果

操作后应将实际结果与文中目标对照；命令成功退出只能证明该步骤完成，不能替代业务层验证。记录异常信息时，保留时间、软件版本与相关上下文，方便后续复查。

## 参考资料

- [官方文档与规范](https://docs.docker.com/reference/cli/docker/compose/pull/)（本次整理参考，页面内容可能随版本更新）
- [继续阅读本站归档](/archives/)