构建Jenkins代理多层Docker镜像遇JAVA_HOME配置异常问题

我是Docker镜像的初学者，正在构建一个多层Docker镜像，将其用作Jenkins代理以执行Maven和Docker构建。对应的多层Dockerfile内容如下：

FROM maven:3.8.3-openjdk-17 as maven
COPY settings.xml /usr/share/maven/conf/ # customized settings.xml 
FROM docker:24.0.0-rc.1-dind as dockerdind 
RUN cd /root &&  mkdir .docker  
COPY --from=maven . /

使用上述Dockerfile构建镜像并创建Pod后，在Pod内执行mvn -version命令时出现如下错误：

/usr/bin/mvn: line 97: which: command not found
The JAVA_HOME environment variable is not defined correctly,
this environment variable is needed to run this program.

但如果仅使用maven:3.8.3-openjdk-17镜像创建Pod，就能在Pod/容器内正常执行mvn命令，输出如下：

mvn -version
Apache Maven 3.8.3 (ff8e977a158738155dc465c6a97ffaf31982d739)
Maven home: /usr/share/maven
Java version: 17.0.1, vendor: Oracle Corporation, runtime: /usr/java/openjdk-17
Default locale: en, platform encoding: UTF-8

请问该如何解决这个JAVA_HOME配置异常的问题？

原因分析 #

1. 基础镜像系统差异：docker:dind镜像基于Alpine Linux，而maven:3.8.3-openjdk-17基于Debian/Ubuntu。Alpine默认没有which命令（对应错误中的第一个报错），且多层构建中，文件复制不会自动继承原镜像的环境变量、PATH配置等元数据，导致JAVA_HOME和Maven相关环境变量丢失。
2. COPY命令的局限性：COPY --from=maven . /仅复制了maven镜像的文件系统内容，原镜像中配置的JAVA_HOME、PATH等环境变量不会被同步到最终的docker:dind镜像中。

解决方案 #

方案1：手动补全依赖与环境变量 #

修改Dockerfile，在最终镜像中安装缺失的工具，并手动配置JAVA_HOME等环境变量，保持和原maven镜像一致：

FROM maven:3.8.3-openjdk-17 as maven
COPY settings.xml /usr/share/maven/conf/ # customized settings.xml 

FROM docker:24.0.0-rc.1-dind as dockerdind 
RUN cd /root &&  mkdir .docker
# 安装Alpine缺失的which工具
RUN apk add --no-cache which
# 复制maven镜像的文件内容
COPY --from=maven . /
# 手动设置JAVA_HOME、Maven相关环境变量
ENV JAVA_HOME=/usr/java/openjdk-17
ENV PATH="$JAVA_HOME/bin:/usr/share/maven/bin:$PATH"
ENV MAVEN_HOME=/usr/share/maven

方案2：切换基础镜像顺序（更推荐） #

如果不需要docker:dind的完整特性，可改为以maven镜像为基础，安装Docker客户端而非完整的dind环境。这种方式能直接继承原maven镜像的所有环境变量和系统依赖，避免配置丢失：

FROM maven:3.8.3-openjdk-17 as maven
COPY settings.xml /usr/share/maven/conf/ # customized settings.xml 

# 以maven镜像为基础，安装Docker客户端
FROM maven:3.8.3-openjdk-17
RUN apt-get update && apt-get install -y --no-install-recommends \
    docker.io \
    && rm -rf /var/lib/apt/lists/*
# 复制自定义的settings.xml
COPY --from=maven /usr/share/maven/conf/settings.xml /usr/share/maven/conf/

验证 #

构建修改后的镜像并创建Pod，执行mvn -version，即可得到和原maven镜像一致的正常输出。

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