如何在同名Docker服务下切换dev与debug容器？

问题背景 #

为foo服务维护了两个Dockerfile：foo-dev.Dockerfile和foo-debug.Dockerfile，仅3行差异——后者安装了delve调试工具。目前通过Makefile传递不同Dockerfile给Docker Compose启动容器，但切换时需手动停止删除当前容器、重新构建，操作繁琐。尝试过Compose的profiles功能，但会导致服务配置重复，希望找到更高效的实现方式。

现有代码片段 #

Makefile #

compose-dev:
    DOCKER_FILE=foo-dev.Dockerfile docker compose up -d

compose-debug: 
    DOCKER_FILE=foo-debug.Dockerfile docker compose up -d

docker-compose.yml #

version: '3'
services: 
  foo: 
    build: 
      context: . 
      dockerfile: ${DOCKER_FILE} 

Dockerfile差异（foo-dev → foo-debug） #

FROM golang:1.20.8-bullseye as builder
+ RUN CGO_ENABLED=0 go install -ldflags "-s -w -extldflags '-static'" github.com/go-delve/delve/cmd/dlv@latest

FROM debian:bullseye-slim
COPY --from=builder /go/bin/foo ./bin/foo
+ COPY --from=builder /go/bin/dlv ./bin/dlv
+ CMD [ "./bin/dlv", "--listen=:4001", "--headless=true", "--log=true", "--accept-multiclient", "--api-version=2", "exec", "./bin/foo"]
- CMD ["./bin/foo", "-debug"]

优化方案 #

方案一：合并Dockerfile，用构建参数控制调试模式 #

将两个Dockerfile合并为一个，通过构建参数DEBUG决定是否安装delve和启用调试启动命令，无需切换Dockerfile即可完成模式切换。

修改后的Dockerfile（foo.Dockerfile）

FROM golang:1.20.8-bullseye as builder

# 定义构建参数，默认关闭调试模式
ARG DEBUG=false
# 编译foo服务（替换为你的实际编译命令）
RUN go build -o /go/bin/foo ./path/to/main.go
# 仅当DEBUG为true时安装delve
RUN [ "$DEBUG" = "true" ] && CGO_ENABLED=0 go install -ldflags "-s -w -extldflags '-static'" github.com/go-delve/delve/cmd/dlv@latest || true

FROM debian:bullseye-slim
# 传递构建参数为环境变量，用于入口脚本判断
ARG DEBUG=false
ENV DEBUG=${DEBUG}

# 复制foo服务二进制文件
COPY --from=builder /go/bin/foo ./bin/foo
# 仅当DEBUG为true时复制delve（忽略复制失败的错误）
COPY --from=builder /go/bin/dlv ./bin/dlv 2>/dev/null || true

# 编写入口脚本，根据DEBUG值选择启动方式
RUN echo '#!/bin/sh\nif [ "$DEBUG" = "true" ]; then\n  exec ./bin/dlv --listen=:4001 --headless=true --log=true --accept-multiclient --api-version=2 exec ./bin/foo\nelse\n  exec ./bin/foo -debug\nfi' > /entrypoint.sh && chmod +x /entrypoint.sh

ENTRYPOINT ["/entrypoint.sh"]

修改docker-compose.yml

version: '3'
services: 
  foo: 
    build: 
      context: . 
      dockerfile: foo.Dockerfile
      args:
        DEBUG: ${DEBUG_MODE:-false}
    # 调试模式下暴露端口，默认不暴露
    ports:
      - "${DEBUG_PORT:-4001}:4001"

修改Makefile

compose-dev:
    DEBUG_MODE=false docker compose up -d --build

compose-debug: 
    DEBUG_MODE=true docker compose up -d --build

切换时只需运行对应的Makefile命令，Compose会根据DEBUG_MODE参数自动构建对应镜像，无需手动删除容器（--build会复用缓存，仅重新执行参数变化的步骤）。

方案二：用Compose扩展字段避免profiles配置重复 #

若不想合并Dockerfile，可通过YAML锚点复用基础配置，避免profiles导致的服务配置重复。

修改docker-compose.yml

version: '3'
# 定义基础服务配置锚点，复用通用设置
x-foo-base: &foo-base
  build:
    context: .
  # 这里添加其他通用配置，比如环境变量、网络、卷挂载等

services: 
  foo-dev:
    <<: *foo-base
    build:
      dockerfile: foo-dev.Dockerfile
    profiles: ["dev"]

  foo-debug:
    <<: *foo-base
    build:
      dockerfile: foo-debug.Dockerfile
    ports:
      - "4001:4001"
    profiles: ["debug"]

修改Makefile

compose-dev:
    # 先停止调试模式服务，再启动开发模式
    docker compose --profile debug down
    docker compose --profile dev up -d --build

compose-debug: 
    # 先停止开发模式服务，再启动调试模式
    docker compose --profile dev down
    docker compose --profile debug up -d --build

切换时运行对应命令即可，Compose会自动处理服务的启停，无需手动操作容器。

方案三：多阶段构建目标选择 #

通过Docker多阶段构建的target参数，选择构建不同阶段的镜像，适合复杂构建流程。

修改后的Dockerfile（foo.Dockerfile）

# 基础构建阶段：编译foo服务
FROM golang:1.20.8-bullseye as base-builder
RUN go build -o /go/bin/foo ./path/to/main.go

# 调试构建阶段：基于基础阶段安装delve
FROM base-builder as debug-builder
RUN CGO_ENABLED=0 go install -ldflags "-s -w -extldflags '-static'" github.com/go-delve/delve/cmd/dlv@latest

# 开发镜像阶段
FROM debian:bullseye-slim as dev-image
COPY --from=base-builder /go/bin/foo ./bin/foo
CMD ["./bin/foo", "-debug"]

# 调试镜像阶段
FROM debian:bullseye-slim as debug-image
COPY --from=debug-builder /go/bin/foo ./bin/foo
COPY --from=debug-builder /go/bin/dlv ./bin/dlv
CMD [ "./bin/dlv", "--listen=:4001", "--headless=true", "--log=true", "--accept-multiclient", "--api-version=2", "exec", "./bin/foo"]

修改docker-compose.yml

version: '3'
services: 
  foo: 
    build: 
      context: . 
      dockerfile: foo.Dockerfile
      target: ${BUILD_TARGET:-dev-image}
    ports:
      - "4001:4001"

修改Makefile

compose-dev:
    BUILD_TARGET=dev-image docker compose up -d --build

compose-debug: 
    BUILD_TARGET=debug-image docker compose up -d --build

这种方式通过指定构建目标切换镜像，保持Dockerfile结构清晰，适合需要区分多个构建阶段的场景。

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