Dockerfile如何在RUN命令及构建阶段间更新传递构建参数

问题根因 #

• Dockerfile 的每一条 RUN 指令都会启动独立的新 shell 会话，前一个 RUN 中通过 export 声明的变量仅在当前会话生效，会话结束后变量会自动销毁。
• 你通过 ARG 定义的 TAG 是构建阶段的全局固定参数，每个新 RUN 进程启动时都会加载 ARG 的初始值，不会保留前一个 RUN 修改后的变量值。

解决方案 #

根据你的使用场景可以选择以下两种实现方式：

1. 仅在当前构建阶段使用 #

将更新后的 TAG 值写入持久化文件，后续需要用到的位置直接读取即可：

FROM python:alpine AS builder

# 仓库地址
ARG REPO
# 发布标签
ARG TAG

# 打印传入的参数
RUN echo Repo 1: $REPO
RUN echo Tag 1: $TAG

# 模拟脚本获取到最新的Tag版本，写入持久化文件
RUN echo "v4.1.0" > /tmp/TAG

# 测试新Tag是否生效
RUN echo Tag 2: $(cat /tmp/TAG)

如果希望后续命令可以直接通过变量名调用 TAG，可以把变量写入全局环境配置：

# 写入全局环境配置
RUN echo "export TAG=v4.1.0" >> /etc/profile.d/custom_tag.sh && chmod +x /etc/profile.d/custom_tag.sh
# 后续RUN执行前先加载配置
RUN source /etc/profile.d/custom_tag.sh && echo Tag 2: $TAG

2. 需要跨构建阶段使用 #

如果更新后的 TAG 需要在后续其他构建阶段中使用，把存储 TAG 的文件从前面的阶段复制过去即可：

# 前面的builder阶段不变
FROM python:alpine AS builder
ARG REPO
ARG TAG
RUN echo "v4.1.0" > /tmp/TAG

# 后续新的构建阶段
FROM alpine AS runtime
# 从builder阶段复制TAG文件
COPY --from=builder /tmp/TAG /tmp/TAG
# 直接读取使用
RUN echo Tag in new stage: $(cat /tmp/TAG)

补充说明：你在 docker-compose.yml 中定义的 environment 是容器运行时的环境变量，和构建阶段的参数是完全隔离的，如果你需要容器运行时也使用更新后的 TAG，可以在构建阶段把 TAG 值写入容器的全局环境配置文件。

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