Docker Build与Buildah：构建时如何从文件设置多环境变量？

Docker 构建的情况 #

Docker 的 docker build 命令没有直接支持 --env-file 这类参数，没法像 docker run 那样直接指定环境变量文件。但可以通过 Shell 命令间接实现：

方法1：先导出变量再传递 #

假设你的 .env 文件内容如下：

APP_NAME=my-app
BUILD_VERSION=1.0.0

可以先把文件里的变量导出到当前 Shell 环境，再用 --build-arg 逐个指定要传递的变量：

export $(cat .env | grep -v '#' | xargs) && docker build --build-arg APP_NAME --build-arg BUILD_VERSION .

• grep -v '#' 用于跳过注释行
• xargs 处理换行和空格，把变量转为 Shell 可识别的格式

方法2：自动生成 --build-arg 参数 #

用 awk 读取 .env 文件，自动生成所有 --build-arg 参数，避免手动逐个编写：

docker build $(awk -F= '{print "--build-arg " $1}' .env) .

如果变量值包含空格或特殊字符，建议先对 .env 文件做转义处理，避免解析出错。

Buildah 构建的情况 #

Buildah 的 bud 命令同样没有直接的 --env-file 选项，但思路和 Docker 一致：通过 Shell 命令读取 .env 文件，生成对应的 --build-arg 参数传递给构建命令。

比如用同样的 awk 方法：

buildah bud $(awk -F= '{print "--build-arg " $1}' .env) .

补充说明 #

• 传递的变量会作为 ARG 在构建阶段生效，如果需要把这些变量保留到最终镜像的运行环境里，需要在 Dockerfile 里用 ENV 指令把 ARG 的值赋值过去，示例：

  ARG APP_NAME
  ENV APP_NAME=$APP_NAME
  

• 如果 .env 文件里有敏感信息，注意不要通过 ENV 将其写入镜像，避免泄露。

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