在Azul Zulu OpenJDK Distroless镜像中使用CMD变量参数失败求助

问题根源 #

1. Exec格式的CMD/ENTRYPOINT不解析变量：使用CMD ["${JAVA_AGENT}", ...]这种exec格式时，Docker会直接将${JAVA_AGENT}作为字面量参数传给Java，导致Java误将其识别为主类名，抛出ClassNotFoundException。
2. Distroless镜像无Shell：去掉[]改用shell格式CMD时，Docker会尝试调用/bin/sh -c执行命令，但distroless镜像默认不包含shell，因此出现stat /bin/sh: no such file or directory错误。

解决方案 #

方案1：复制Shell到Distroless镜像 #

从build阶段的Alpine镜像中复制sh到目标镜像，通过shell执行命令来解析环境变量：

FROM alpine:3.17.3 as build-env

ARG DATADOG_VERSION=1.8.3

RUN wget https://github.com/DataDog/dd-trace-java/releases/download/v${DATADOG_VERSION}/dd-java-agent-${DATADOG_VERSION}.jar
# 复制Alpine的shell到临时目录
RUN cp /bin/sh /tmp/sh

FROM azul/zulu-openjdk-distroless:17.0.6

# 复制shell到目标镜像
COPY --from=build-env /tmp/sh /bin/sh
COPY --from=build-env dd-java-agent-*.jar javaagent.jar
COPY *-app/target/*.jar app.jar

# 定义环境变量，支持外部传入覆盖
ENV JAVA_AGENT="-javaagent:javaagent.jar"
ENV JAVA_OPTS=""

# 用shell执行命令，自动解析环境变量
CMD ["/bin/sh", "-c", "java $JAVA_AGENT $JAVA_OPTS -jar app.jar"]

方案2：使用带Shell的Distroless变体 #

部分OpenJDK distroless镜像提供带shell的版本（如Azul的azul/zulu-openjdk-distroless:17.0.6-slim，需确认镜像可用性），直接使用该镜像可省去复制shell的步骤：

FROM alpine:3.17.3 as build-env

ARG DATADOG_VERSION=1.8.3

RUN wget https://github.com/DataDog/dd-trace-java/releases/download/v${DATADOG_VERSION}/dd-java-agent-${DATADOG_VERSION}.jar

FROM azul/zulu-openjdk-distroless:17.0.6-slim

COPY --from=build-env dd-java-agent-*.jar javaagent.jar
COPY *-app/target/*.jar app.jar

ENV JAVA_AGENT="-javaagent:javaagent.jar"
ENV JAVA_OPTS=""

CMD ["/bin/sh", "-c", "java $JAVA_AGENT $JAVA_OPTS -jar app.jar"]

使用说明 #

• 流水线传递变量：通过docker run -e JAVA_OPTS="-Xmx512m -Xms256m"或CI/CD平台的环境变量设置，可动态覆盖JAVA_OPTS等参数。
• 默认值覆盖：Dockerfile中定义的ENV值作为默认参数，外部传入的环境变量会自动覆盖默认值。

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