容器与云原生 / 知识点

Docker Compose 配置与运维速查手册

手册条目

跳过构建缓存以排除旧层或依赖未更新问题。

无缓存重新构建

当镜像仍包含旧依赖、旧构建产物或异常缓存层时,用 docker compose build --no-cache 重新执行 Dockerfile 的每个构建步骤;需要同时刷新基础镜像时再加 --pull。该操作只重建镜像,不会自动替换正在运行的容器。:contentReference[oaicite:0]{index=0}

命令定位

只处理 Compose 中带 build: 的服务。优先指定单个服务,避免整个项目无差别重建;镜像构建成功后,再用 docker compose up -d 让目标容器采用新镜像。

基本语法

bash
docker compose build --no-cache [--pull] [SERVICE...]

--no-cache 禁止本次构建复用 Dockerfile 层缓存;--pull 始终尝试拉取更新的基础镜像;SERVICE... 省略时会构建所有可构建服务。:contentReference[oaicite:1]{index=1}

高频用法

下面以 web 服务为例,先彻底重建镜像,再仅重建并启动该服务,避免无关依赖被重启。

bash
# 跳过构建缓存,并检查基础镜像是否有更新
docker compose build --no-cache --pull web
# 使用新镜像替换 web 容器,不主动启动其依赖
docker compose up -d --no-deps web

预期输出

text
[+] Building <TIME> (12/12) FINISHED
[+] Running 1/1
 ✔ Container <PROJECT>-web-1  <ACTION>

<TIME>、项目名和步骤数会变化;<ACTION> 常见为 Started 或 Recreated。出现 FINISHED 表示镜像构建完成,随后容器状态成功即表示新镜像已应用。

风险与边界

触发全量无缓存构建时,每一层都要重新执行,可能显著增加耗时、网络流量和仓库限流风险。安全做法是先限定服务,并仅在基础镜像也需刷新时使用 --pull。

--no-cache 不会删除现有构建缓存,也不会清理命名卷。若旧文件来自挂载卷,重建镜像仍不会改变卷内数据;不要直接执行 docker compose down -v,否则可能删除数据库等持久化数据,应先确认挂载来源并备份。

排障清单

  • 代码仍未更新:确认 Compose 使用了正确的文件、项目目录和 build.context,并检查 .dockerignore 是否排除了目标文件。
  • 基础镜像仍旧:确认已加 --pull;若 Dockerfile 固定了镜像摘要,版本不变化属于预期行为。
  • 依赖仍旧:检查依赖是否被复制进镜像,还是来自 bind mount、命名卷或外部包缓存。
  • 构建成功但服务未变化:执行 docker compose up -d --no-deps web,再通过服务日志或版本接口验证实际运行版本。

速查:无缓存构建解决的是镜像层复用问题,不等同于清卷、清宿主机文件或自动更新运行中容器。

目录与阅读设置

记录一个想法

Docker Compose 配置与运维速查手册

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

登录哪都通