如何让.env文件变量在Docker构建及容器运行时均可用

问题概述 #

现有唯一环境变量源oneSourceOfTruth.env，需要让其中的所有变量同时在docker compose build的构建阶段（如Dockerfile的RUN命令）和docker compose up的容器运行时可用。当前env_file仅能传递变量给运行容器，构建阶段无法获取，且需满足仅修改.env文件即可增删变量的约束。

可行方案 #

方案核心思路 #

通过在构建阶段将oneSourceOfTruth.env复制到镜像内，在构建脚本和容器启动脚本中加载该文件，实现单数据源同时支持构建与运行时。

步骤1：修改docker-compose.yml #

添加构建参数传递.env文件路径，同时保留原env_file保证运行时变量注入：

services:
  my-service:
    dockerfile: ./Dockerfile
    env_file: oneSourceOfTruth.env
    build:
      args:
        ENV_FILE: oneSourceOfTruth.env

步骤2：修改Dockerfile #

接收构建参数、复制.env文件，并在构建阶段和启动阶段加载该文件：

# 接收构建阶段传入的.env文件路径参数
ARG ENV_FILE
# 将环境变量文件复制到镜像工作目录
COPY ${ENV_FILE} /app/.env

# 设置工作目录
WORKDIR /app

# 构建阶段加载.env文件执行资产预编译，未设置的变量会触发KeyError提前报错
RUN source /app/.env && DB_ADAPTER=nulldb bundle exec rails assets:precompile

# 容器启动时加载.env文件（双重保障：既兼容docker-compose的env_file，也支持镜像单独运行）
CMD ["sh", "-c", "source /app/.env && exec rails server"]

方案优势 #

• 完全符合约束：仅需修改oneSourceOfTruth.env即可增删变量，无需改动Dockerfile或docker-compose.yml的变量定义部分
• 构建阶段变量可用：通过source /app/.env让Rails预编译时能读取所有变量，未设置的变量会触发KeyError，提前发现配置问题
• 运行时双重保障：既保留env_file的变量注入，又在启动脚本中加载.env，兼顾Docker Compose部署和镜像单独运行场景

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