如何使用共享Dockerfile模板为多个子Dockerfile注入自定义变量？

直接通过Docker内置的ARG指令定义可注入变量，所有服务共用同一份Dockerfile，仅在构建时传入差异化参数即可：

通用Dockerfile模板 #

FROM golang:1.17 AS builder
WORKDIR /app
COPY . .
RUN go mod download
RUN go build -o /bin/app ./cmd/root.go

FROM alpine:latest
# 定义可注入的变量，可设置默认值
ARG SERVICE_PORT=8080
ARG IMAGE_SOURCE
WORKDIR /bin/
COPY --from=builder /bin/app .
EXPOSE ${SERVICE_PORT}
LABEL org.opencontainers.image.source="${IMAGE_SOURCE}"
ENTRYPOINT ["/bin/app"]
CMD ["server", "--env=dev"]

构建命令示例 #

需要暴露不同端口时，通过--build-arg参数传入对应值即可：

# 构建auth服务，暴露8080端口
docker build --build-arg SERVICE_PORT=8080 --build-arg IMAGE_SOURCE="https://github.com/mohammadne/bookman-auth" -t bookman-auth:v1 .

# 构建user服务，暴露8081端口
docker build --build-arg SERVICE_PORT=8081 --build-arg IMAGE_SOURCE="https://github.com/mohammadne/bookman-user" -t bookman-user:v1 .

如果需要为每个服务维护单独的Dockerfile文件，可以先把公共逻辑打包为公共基础镜像，子Dockerfile仅需声明差异化配置即可：

步骤1：构建公共基础镜像 #

编写公共基础镜像的Dockerfile（例如命名为Dockerfile.base）：

FROM golang:1.17 AS builder
WORKDIR /app
COPY . .
RUN go mod download
RUN go build -o /bin/app ./cmd/root.go

FROM alpine:latest
WORKDIR /bin/
COPY --from=builder /bin/app .
ENTRYPOINT ["/bin/app"]
CMD ["server", "--env=dev"]

构建并推送到你的私有镜像仓库：

docker build -f Dockerfile.base -t my-org/go-service-base:v1 .
# 推送到镜像仓库命令根据你使用的仓库调整
docker push my-org/go-service-base:v1

步骤2：编写子服务Dockerfile #

每个服务的Dockerfile仅需几行即可完成，完全复用基础镜像的逻辑：

# auth服务Dockerfile
FROM my-org/go-service-base:v1
EXPOSE 8080
LABEL org.opencontainers.image.source="https://github.com/mohammadne/bookman-auth"

# user服务Dockerfile
FROM my-org/go-service-base:v1
EXPOSE 8081
LABEL org.opencontainers.image.source="https://github.com/mohammadne/bookman-user"

两种方案都可以无缝扩展后续的差异化配置，比如不同的启动参数、环境变量等，无需修改公共逻辑部分。

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