单Dockerfile适配多Ubuntu版本失效问题求助

问题背景 #

原本通过单个Dockerfile构建不同Ubuntu版本镜像，利用ARG ${distro}=" "动态定义ARG变量，配合bash参数展开（如${focal:+10}）处理版本差异（比如安装对应版本编译器）。Docker升级后该逻辑失效，本地bash测试正常，但Dockerfile中参数展开无法正确识别动态变量。

复现案例 #

原Dockerfile

ARG baseimage
ARG distro
ARG ${distro}=" "

FROM $baseimage AS base_image
ARG distro
ARG ${distro}=" "

RUN echo "arg is ${distro}" > /test.log
RUN echo "distro is ${focal:+Focal}${jammy:+Jammy} ${focal:-not Focal}${jammy:-not Jammy}" >> /test.log

CMD sleep infinity

构建命令

baseimage='ubuntu:focal'
distro='focal'
docker build . -t testimage:${distro} --build-arg distro=${distro} --build-arg baseimage=${baseimage} -f Dockerfile --target base_image

预期与实际输出

预期/test.log内容：

arg is focal
distro is Focal not Jammy

实际输出：

arg is focal
distro is  not Focalnot Jammy

可能原因 #

Docker新版本修改了ARG解析规则，不再支持ARG ${distro}这种动态变量名的定义，导致对应版本变量（如focal）未被正确注册为环境变量，bash参数展开无法匹配到有效变量。

解决方案 #

方案1：在RUN阶段显式导出动态变量 #

将动态变量的定义移到RUN的bash环境中，直接通过export创建变量，避免Docker构建阶段的ARG解析限制：

ARG baseimage
ARG distro

FROM $baseimage AS base_image
ARG distro

# 在同一个RUN命令里导出变量并执行逻辑，确保变量生效
RUN export ${distro}=" " && \
    echo "arg is ${distro}" > /test.log && \
    echo "distro is ${focal:+Focal}${jammy:+Jammy} ${focal:-not Focal}${jammy:-not Jammy}" >> /test.log

CMD sleep infinity

方案2：直接传递版本标识构建参数 #

放弃动态ARG定义，直接为每个Ubuntu版本声明ARG，构建时传递对应版本的参数：

ARG baseimage
# 为每个需要支持的版本声明ARG，默认空值
ARG focal=""
ARG jammy=""

FROM $baseimage AS base_image
ARG focal=""
ARG jammy=""

RUN echo "distro is ${focal:+Focal}${jammy:+Jammy} ${focal:-not Focal}${jammy:-not Jammy}" >> /test.log

CMD sleep infinity

对应构建命令（以focal为例）：

baseimage='ubuntu:focal'
docker build . -t testimage:focal --build-arg focal=" " --build-arg baseimage=${baseimage} -f Dockerfile --target base_image

方案3：用独立shell脚本封装逻辑 #

将版本判断逻辑写入单独的shell脚本，COPY到镜像中执行，确保完全使用bash的特性：

1. 创建setup.sh脚本：

#!/bin/bash
# 接收distro参数，导出对应变量
export $1=" "
echo "arg is $1" > /test.log
echo "distro is ${focal:+Focal}${jammy:+Jammy} ${focal:-not Focal}${jammy:-not Jammy}" >> /test.log

2. 修改Dockerfile：

ARG baseimage
ARG distro

FROM $baseimage AS base_image
ARG distro

COPY setup.sh /
RUN chmod +x /setup.sh && /setup.sh ${distro}

CMD sleep infinity

这种方式完全脱离Docker构建阶段的变量解析限制，兼容性最好。

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