Docker多阶段构建使用LABEL筛选中间镜像失败问题咨询

• Docker多阶段构建的默认逻辑是仅将最后一个阶段的构建结果作为正式镜像输出到本地镜像列表，你在one阶段定义的LABEL build=here仅属于中间阶段的镜像，默认不会出现在docker images的返回结果中，所以过滤不到对应镜像。
• 单阶段构建时唯一的构建阶段就是最终输出阶段，所以LABEL会被携带到最终镜像里，能正常被检索到。
• 该逻辑是Docker的通用设计，和你使用的Docker Desktop for Mac平台无关，不属于平台兼容性问题。

方案1：单独构建目标中间阶段 #

如果你需要获取one阶段的镜像，构建时添加--target参数指定构建阶段即可，将对应阶段的镜像正式输出到本地列表：

docker build --target one -f Dockerfile.two .

后续用LABEL过滤就能正常找到对应镜像。

方案2：直接导出产物无需操作镜像 #

Docker原生支持直接将指定阶段的文件导出到宿主机，不需要创建容器拷贝，更适合CI场景：

# 直接把one阶段的/test目录导出到当前目录的test文件夹
docker build --target one --output type=local,dest=./test -f Dockerfile.two .

方案3：检索所有镜像（含中间缓存） #

如果不想修改构建命令，可以在查询镜像时添加-a参数，展示所有镜像（包括中间缓存镜像）就能匹配到带标签的中间阶段镜像：

docker images -a --filter 'label=build=here'

注意该方式可能匹配到历史构建的旧缓存镜像，CI场景优先选择前两种方案。

内容的提问来源于stack exchange，提问作者Niel de Wet