Docker Compose复用镜像时重复构建问题排查求助

重复构建的原因及解决方法 #

你的docker-compose.yml中，app1服务同时定义了build和image字段。即便你已经通过docker compose build完成镜像构建，每次执行docker compose up时，Compose仍会默认检查build配置对应的上下文（.）和内联Dockerfile是否有变更——哪怕实际没有变化，也可能触发重新构建。

解决这个问题有两种规范方式：

• 方式一：移除app1的build配置
  既然已构建好app-image:latest镜像，直接让两个服务都引用该镜像即可，修改后的配置如下：

  version: "3"
  
  services:
    app1:
      image: app-image:latest
      command: "bundle exec puma"
      restart: "unless-stopped"
      ports:
        - "80:9292"
    app2:
      image: app-image:latest
      command: "bundle exec puma"
      restart: "unless-stopped"
      ports:
        - "81:9292"
  

  之后执行docker compose up就不会再触发构建。

• 方式二：使用顶层build定义（推荐）
  若需要保留构建能力，把构建配置移到顶层，让两个服务共享镜像，Compose只会执行一次构建：

  version: "3"
  
  services:
    app1:
      image: app-image:latest
      command: "bundle exec puma"
      restart: "unless-stopped"
      ports:
        - "80:9292"
    app2:
      image: app-image:latest
      command: "bundle exec puma"
      restart: "unless-stopped"
      ports:
        - "81:9292"
  
  build:
    context: .
    dockerfile_inline: |
      FROM ruby:3.2-alpine
      (...)
      RUN bundle install
  

  构建时执行docker compose build，启动时docker compose up不会重复构建。

获取警告和错误详情的方法 #

要查看模糊的app1 Warning和app2 Error具体内容，可通过以下方式：

• 启动时输出详细日志：执行docker compose up --verbose，该参数会输出Compose运行过程的所有细节，包括构建阶段的警告、错误信息。
• 查看服务日志：启动后执行docker compose logs app1或docker compose logs app2，能获取服务启动及运行阶段的完整日志。
• 重新构建并查看完整输出：如果是构建阶段的问题，执行docker compose build --no-cache --progress=plain app1，强制重新构建并以纯文本格式输出完整构建过程，便于定位问题。

内容的提问来源于stack exchange，提问作者svoop