如何基于外部配置文件在Dockerfile中设置基础镜像（支持标准构建命令）

方法一：Shell脚本封装构建流程 #

这是最贴合需求的方案，既能自动从config.json读取配置，又完全兼容基础docker build命令的使用习惯。

1. 编写Dockerfile：定义基础镜像的ARG参数，无需硬编码值：

ARG BASE_IMAGE_REPO
ARG BASE_IMAGE_TAG
FROM ${BASE_IMAGE_REPO}:${BASE_IMAGE_TAG}
# 后续构建步骤...

2. 创建构建脚本build.sh：

#!/bin/bash

# 从config.json解析repo和tag（依赖jq工具，无jq可看下方替代方案）
BASE_REPO=$(jq -r '.repo' config.json)
BASE_TAG=$(jq -r '.tag' config.json)

# 执行docker build，自动传入解析后的参数，同时保留用户传入的所有额外参数
docker build \
  --build-arg BASE_IMAGE_REPO=$BASE_REPO \
  --build-arg BASE_IMAGE_TAG=$BASE_TAG \
  "$@"

3. 使用方式：
   • 赋予脚本执行权限后，直接运行即可（和基础命令体验一致）：

     chmod +x build.sh
     ./build.sh -t foo:bar .
     

   • 若需临时覆盖配置文件中的镜像，直接追加--build-arg参数即可：

     ./build.sh -t foo:bar . --build-arg BASE_IMAGE_REPO=debian --build-arg BASE_IMAGE_TAG=bookworm
     

无jq环境的替代方案 #

如果你的环境没有jq工具，可以用Python内置的JSON模块解析配置，把脚本中的解析部分替换为：

BASE_REPO=$(python3 -c "import json; print(json.load(open('config.json'))['repo'])")
BASE_TAG=$(python3 -c "import json; print(json.load(open('config.json'))['tag'])")

方法二：Makefile简化调用 #

若你习惯使用Make工具，也可以用Makefile封装逻辑：

1. 编写Makefile：

# 从config.json读取配置
BASE_REPO := $(shell jq -r '.repo' config.json)
BASE_TAG := $(shell jq -r '.tag' config.json)

# 默认构建目标，允许指定TAG参数
build:
	docker build \
		--build-arg BASE_IMAGE_REPO=$(BASE_REPO) \
		--build-arg BASE_IMAGE_TAG=$(BASE_TAG) \
		-t $(TAG) .

.PHONY: build

2. 使用方式：

make build TAG=foo:bar

核心说明 #

Dockerfile本身无法在FROM指令阶段读取外部配置文件（FROM属于构建前置步骤，此时还未加载构建上下文），因此必须借助外部工具提前解析配置，再通过--build-arg参数传入构建流程。

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