Dockerfile中基础镜像的STAGE参数无法传递至运行时镜像求助

问题原因 #

Docker多阶段构建里，每个FROM指令会启动独立的构建阶段，阶段间的ARG/ENV变量不会自动继承。你在base阶段声明的STAGE参数，不会自动传递到runtime阶段，所以runtime阶段只能拿到environment_default的默认值sbx。

解决方案 #

方法1：在Runtime阶段重新声明STAGE参数并传递

直接在runtime阶段重新声明STAGE参数，构建时的--build-arg会自动传递给所有声明了该参数的阶段。修改后的Dockerfile如下：

ARG environment_default=sbx
FROM docker.image.net/dotnet:latest AS base
ARG STAGE
RUN echo $STAGE # 此处能获取到sandbox值

ENV environment_default=$STAGE
RUN echo $environment_default

# 其他代码

FROM docker.image.net/dotnet:latest AS runtime
ARG STAGE  # 重新声明STAGE参数
ARG environment_default=$STAGE  # 用STAGE的值覆盖默认值
RUN echo $environment_default # 现在能获取到sandbox值

ENV ASPNETCORE_ENVIRONMENT=$environment_default
RUN echo $ASPNETCORE_ENVIRONMENT

# 其他代码

ENTRYPOINT ["dotnet","exec","MY.Web.dll"]

构建命令保持不变：

docker build --build-arg STAGE=$Stage -t $REPOSITORY_URI:latest .

方法2：从Base阶段复制环境变量（备选）

如果需要传递base阶段已处理的变量，可以将变量写入文件后复制到runtime阶段：

FROM docker.image.net/dotnet:latest AS base
ARG STAGE
RUN echo $STAGE > /stage_value.txt
ENV environment_default=$STAGE
RUN echo $environment_default

# 其他代码

FROM docker.image.net/dotnet:latest AS runtime
COPY --from=base /stage_value.txt /stage_value.txt
# 读取文件内容并设置环境变量
RUN export environment_default=$(cat /stage_value.txt) && \
    echo $environment_default && \
    echo "ASPNETCORE_ENVIRONMENT=$environment_default" > /etc/environment

ENV ASPNETCORE_ENVIRONMENT=$environment_default
RUN echo $ASPNETCORE_ENVIRONMENT

# 其他代码

ENTRYPOINT ["dotnet","exec","MY.Web.dll"]

推荐方案 #

优先选择方法1，它直接利用Docker的构建参数传递机制，逻辑清晰且无需额外文件操作，是多阶段构建中传递参数的标准方式。

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