Dockerfile中COPY指令--from参数能否使用变量指定源镜像？

问题结论 #

可以在COPY指令的--from参数中使用变量，你遇到的报错是ARG变量的作用域不符合要求导致的。

你收到的报错invalid from flag value my-image:$MY_VERSION: invalid reference format的中文含义为：--from参数值my-image:$MY_VERSION无效：镜像引用格式错误。该错误触发的原因是：Docker解析Dockerfile时，COPY --from的参数属于预处理阶段就要确定的值，你在构建阶段内部定义的ARG仅能在当前阶段的运行指令（比如RUN、ENV）中生效，无法被预处理阶段读取，变量没有被替换就直接拼接成了镜像名，最终不符合镜像引用规范。

正确实现方式 #

需要把用到--from参数中的ARG变量定义在所有FROM指令的最顶部，属于全局作用域的ARG才能被预处理阶段解析识别：

# 全局ARG必须放在所有FROM之前才能被--from参数读取
ARG MY_VERSION

# 你的任意基础镜像或构建阶段
FROM alpine:3.18
# 此时变量可以正常被解析替换
COPY --from=my-image:${MY_VERSION} /src /dst

注意事项 #

• Docker版本需要 ≥ 17.05，该版本开始支持多阶段构建和全局ARG特性
• 变量建议使用${变量名}的完整写法，不要省略大括号，避免解析时和后续字符混淆
• 构建镜像时需要传入对应参数，否则变量为空也会触发镜像引用格式错误：

  docker build --build-arg MY_VERSION=v1.0.0 .
  

如果需要引用同个Dockerfile内的动态阶段别名，也可以用同样的方式实现：

ARG MY_VERSION
ARG BUILD_STAGE=pre-build

FROM my-image:${MY_VERSION} AS ${BUILD_STAGE}
RUN echo "测试内容" > /test.txt

FROM alpine:3.18
COPY --from=${BUILD_STAGE} /test.txt /test.txt

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