如何在Docker容器启动时动态注入XML配置中的数据库、ElastiCache参数

核心思路 #

把XML格式的RusticiEngineSettings.properties做成模板文件，将需要动态替换的参数（数据库连接串、ElastiCache地址等）用环境变量占位符标记，容器启动时通过脚本读取外部传入的环境变量，替换模板中的占位符生成最终配置，再启动应用。

具体实现步骤 #

1. 将配置文件改为模板格式 #

把原配置中的固定参数替换为占位符（比如${DB_CONN_STR}、${ELASTICACHE_ADDR}），示例如下：

原配置片段：

<property name="dbConnectionString" value="jdbc:mysql://localhost:3306/engine?useSSL=false"/>
<property name="elasticacheEndpoint" value="localhost:6379"/>

修改为模板（保存为RusticiEngineSettings.properties.template）：

<property name="dbConnectionString" value="${DB_CONN_STR}"/>
<property name="elasticacheEndpoint" value="${ELASTICACHE_ADDR}"/>

2. 编写启动脚本 #

创建start-app.sh脚本，负责替换模板变量并启动应用：

#!/bin/sh

# 用环境变量替换模板内容，生成最终配置文件
envsubst < /app/config/RusticiEngineSettings.properties.template > /app/config/RusticiEngineSettings.properties

# 启动应用（替换为你的实际启动命令）
exec /app/bin/start-your-app

给脚本添加执行权限：chmod +x start-app.sh

3. 更新Dockerfile #

将模板、启动脚本复制到镜像，设置启动命令为脚本：

# 替换为你的实际基础镜像
FROM openjdk:11-jre-slim

# 创建配置目录
RUN mkdir -p /app/config

# 复制模板、启动脚本和应用程序
COPY RusticiEngineSettings.properties.template /app/config/
COPY start-app.sh /app/
COPY your-app.jar /app/

# 安装envsubst（基础镜像若无则需添加）
RUN apt-get update && apt-get install -y --no-install-recommends gettext-base && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /app

# 启动命令
CMD ["./start-app.sh"]

4. 启动容器时传入参数 #

通过-e参数传入实际的环境变量值：

docker run -d \
  -e DB_CONN_STR="jdbc:mysql://prod-db:3306/engine?useSSL=true" \
  -e ELASTICACHE_ADDR="prod-cache:6379" \
  your-image-tag:latest

备选方案：直接用sed替换（无需模板） #

如果不想维护模板，也可以直接在启动脚本中用sed替换原配置的固定值：

#!/bin/sh

# 替换数据库连接串
sed -i "s|jdbc:mysql://localhost:3306/engine?useSSL=false|${DB_CONN_STR}|g" /app/config/RusticiEngineSettings.properties

# 替换ElastiCache地址
sed -i "s|localhost:6379|${ELASTICACHE_ADDR}|g" /app/config/RusticiEngineSettings.properties

# 启动应用
exec /app/bin/start-your-app

这种方式要求原配置中的默认值是唯一且固定的，避免误替换其他内容。

注意事项 #

• 若基础镜像没有envsubst或sed，需在Dockerfile中安装（Alpine镜像用apk add gettext，Debian/Ubuntu用apt-get install gettext-base）。
• 敏感参数（如数据库密码）不要硬编码，建议用Docker Secrets或安全的环境变量传递方式。
• 启动脚本中用exec启动应用，确保应用进程成为容器的PID 1，能正确接收终止信号（比如docker stop）。

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