Docker多阶段构建中能否实现镜像动态解析？

在Docker多阶段构建中，是可以实现镜像的动态解析的，但核心要注意ARG指令的作用域，这直接决定变量能否被正确引用。

能正常运行的写法分析 #

这种写法中，ARG指令放在所有FROM之前，属于全局ARG，所有构建阶段都能直接引用这个变量：

ARG node_version=10-alpine

FROM node:${node_version} as stage1

此时node:${node_version}会被正确解析为node:10-alpine，构建正常执行。

执行失败的原因 #

下面的写法中，ARG是定义在第一个构建阶段之后的，属于阶段级ARG，只能在dbdump阶段生效，后续的stage1阶段无法访问这个变量：

FROM ubuntu as dbdump

ARG node_version=10-alpine

FROM node:${node_version} as stage1

因为stage1阶段无法获取node_version的值，${node_version}会被解析为空字符串，最终变成node:，触发镜像引用格式错误，对应报错：

Dockerfile:5
--------------------
   3 |     ARG node_version=10-alpine
   4 |
   5 | >>> FROM node:${node_version} as stage1
   6 |
   7 |
--------------------
ERROR: failed to solve: failed to parse stage name "node:": invalid reference format

解决方案 #

有两种可靠的处理方式：

1. 定义全局ARG（推荐）

将ARG放在所有FROM指令之前，让所有构建阶段都能继承这个变量：

ARG node_version=10-alpine

FROM ubuntu as dbdump

FROM node:${node_version} as stage1

2. 在目标阶段重新声明ARG

如果需要在特定阶段单独控制变量，或者全局ARG已通过构建命令传入，可以在目标阶段重新声明该变量（可指定默认值或直接继承全局值）：

FROM ubuntu as dbdump

FROM node:${node_version} as stage1
ARG node_version=10-alpine  # 在此阶段声明变量，确保能解析

如果构建时通过--build-arg node_version=18-alpine传入值，也可以省略默认值，直接写ARG node_version。

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