如何不修改CMD exec格式实现Dockerfile中Java启动参数动态配置

你不需要修改原有CMD的exec格式，也无需引入sh -c，可通过以下两种方案实现参数动态调整，同时解决log4j2环境变量读取异常的问题：

方案一：使用Datadog原生支持的环境变量（最优） #

Datadog Java Agent 天生支持通过环境变量覆盖配置项，优先级高于启动命令中指定的-D系统属性：

• 环境变量DD_ENV对应-Ddd.env配置
• 环境变量DD_AGENT_HOST对应-Ddd.agent.host配置

Dockerfile修改示例 #

# 声明构建时可传参数，设置默认值
ARG DD_ENV=default_env
ARG DD_AGENT_HOST=172.17.0.2
# 将构建参数转为容器环境变量
ENV DD_ENV=${DD_ENV}
ENV DD_AGENT_HOST=${DD_AGENT_HOST}

# 原有CMD保持不变，无需任何修改
CMD ["java", "-javaagent:dd-java-agent.jar", "-Ddd.env=my_env", "-Ddd.agent.host=172.17.0.2", "-jar", "app.jar"]

使用方式 #

• 构建时自定义参数：docker build --build-arg DD_ENV=prod --build-arg DD_AGENT_HOST=192.168.1.100 .
• 运行时覆盖参数：docker run -e DD_ENV=test -e DD_AGENT_HOST=10.0.0.2 你的镜像名

方案二：使用JVM标准JAVA_TOOL_OPTIONS环境变量（通用） #

如果不希望依赖Datadog的专属环境变量，可使用JVM原生支持的JAVA_TOOL_OPTIONS，该环境变量中的参数会被JVM自动追加到启动参数中，优先级高于CMD里写死的参数。

Dockerfile修改示例 #

# 声明构建时可传参数，设置默认值
ARG DD_ENV=default_env
ARG DD_AGENT_HOST=172.17.0.2
# 配置JVM自动读取的启动参数
ENV JAVA_TOOL_OPTIONS="-Ddd.env=${DD_ENV} -Ddd.agent.host=${DD_AGENT_HOST}"

# 原有CMD保持不变，无需任何修改
CMD ["java", "-javaagent:dd-java-agent.jar", "-Ddd.env=my_env", "-Ddd.agent.host=172.17.0.2", "-jar", "app.jar"]

原sh -c方案异常原因说明 #

使用CMD ["sh", "-c", "java ..."]格式时，sh进程会作为PID1启动，java进程作为sh的子进程运行，环境变量传递链路变长，容易出现部分环境变量未正确继承的问题，进而导致log4j2无法读取${env:service-host}。
上述两种方案均保留了CMD的exec格式，java进程直接作为容器PID1启动，会完整继承容器的所有环境变量，完全避免该问题。

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