Dockerfile中如何基于架构条件组合环境变量

我在为Docker项目启用多架构构建时，需要根据架构条件修改环境变量。原Dockerfile末尾的环境变量设置如下：

ENV GROBID_SERVICE_OPTS "-Djava.library.path=grobid-home/lib/lin-64:grobid-home/lib/lin-64/jep --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/sun.nio.ch=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED"

我希望当架构为ARM64时，给这个环境变量添加-Djdk.lang.Process.launchMechanism=vfork参数。于是尝试通过检查TARGETARCH实现：

ARG TARGETARCH
ARG PROCESS_MECHANISM

RUN if [ "$TARGETARCH" = "arm64" ]; then \
        PROCESS_MECHANISM="-Djdk.lang.Process.launchMechanism=vfork "; \
    else \
        PROCESS_MECHANISM=""; \
    fi

RUN echo "Selected process spawning mechanism: $PROCESS_MECHANISM"

ENV GROBID_SERVICE_OPTS "$PROCESS_MECHANISM-Djava.library.path=grobid-home/lib/lin-64:grobid-home/lib/lin-64/jep --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/sun.nio.ch=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED"

但设置的PROCESS_MECHANISM变量在后续步骤中丢失了。

问题原因 #

每个RUN指令都会在独立的容器层中执行，层与层之间的shell变量不共享。第一个RUN中设置的PROCESS_MECHANISM只是当前临时shell的局部变量，无法传递到下一个RUN或ENV指令。此外，ARG变量仅在定义后的构建阶段生效，跨层时不会自动保留。

解决方案 #

方法1：直接在ENV指令中嵌入条件判断（推荐）

无需额外RUN指令，利用Docker的变量插值和shell条件判断直接生成环境变量值：

ARG TARGETARCH
ENV GROBID_SERVICE_OPTS "\
    $(if [ "$TARGETARCH" = "arm64" ]; then echo "-Djdk.lang.Process.launchMechanism=vfork "; fi)\
    -Djava.library.path=grobid-home/lib/lin-64:grobid-home/lib/lin-64/jep \
    --add-opens java.base/java.lang=ALL-UNNAMED \
    --add-opens java.base/sun.nio.ch=ALL-UNNAMED \
    --add-opens java.base/java.io=ALL-UNNAMED"

这种方式直接在ENV步骤中动态生成参数，彻底避免了跨层变量丢失的问题，简洁高效。

方法2：通过文件传递变量（适用于复杂场景）

如果需要更复杂的逻辑，可以将变量值写入文件，再通过ARG读取：

ARG TARGETARCH
RUN if [ "$TARGETARCH" = "arm64" ]; then \
        echo "-Djdk.lang.Process.launchMechanism=vfork " > /tmp/process_mechanism; \
    else \
        echo "" > /tmp/process_mechanism; \
    fi
ARG PROCESS_MECHANISM=$(cat /tmp/process_mechanism)
ENV GROBID_SERVICE_OPTS "$PROCESS_MECHANISM-Djava.library.path=grobid-home/lib/lin-64:grobid-home/lib/lin-64/jep --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/sun.nio.ch=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED"

注意：此方法需要Docker启用BUILDKIT（Docker 18.09及以上版本默认支持）。

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