Docker运行镜像时如何传入YML配置文件以替换默认配置

你可以通过改造镜像的Entrypoint启动脚本实现需求，整个实现流程如下： #

步骤1：调整Dockerfile配置 #

首先在Dockerfile中完成默认配置存入、启动脚本注入、权限配置等操作，示例如下：

# 替换为你实际使用的基础镜像
FROM alpine:3.18

# 复制本地的默认配置文件到镜像内的专属路径，避免被意外覆盖
COPY ./config.yml /app/default-config.yml
# 复制启动脚本到镜像内
COPY entrypoint.sh /app/entrypoint.sh

# 可选：定义程序读取配置的默认路径为环境变量，方便后续维护
ENV CONFIG_PATH=/app/runtime-config.yml

# 给启动脚本和配置路径分配权限
RUN chmod +x /app/entrypoint.sh \
    && mkdir -p /app \
    # 如果使用非root用户运行程序，需要额外修改路径所有者，示例如下：
    # && chown -R appuser:appuser /app

# 设置入口点为启动脚本
ENTRYPOINT ["/app/entrypoint.sh"]
# 替换为你实际的程序启动命令
CMD ["your-main-program"]

步骤2：编写Entrypoint启动脚本 #

entrypoint.sh 是容器启动时优先执行的逻辑，负责判断是否有用户传入的自定义配置，没有就用默认配置，示例代码如下：

#!/bin/sh

# 第一步：判断指定路径下是否有用户挂载的自定义配置
if [ ! -f "${CONFIG_PATH}" ]; then
    # 无自定义配置，复制内置默认配置到运行时读取路径
    cp /app/default-config.yml "${CONFIG_PATH}"
fi

# 第二步：判断用户是否传入了--config参数指定自定义配置路径
HAS_CUSTOM_CONFIG=0
for arg in "$@"; do
    if [ "${arg}" = "--config" ] || [ "${arg}" = "-c" ]; then
        HAS_CUSTOM_CONFIG=1
        break
    fi
done

# 第三步：如果用户没有指定配置参数，自动追加默认配置路径参数
if [ ${HAS_CUSTOM_CONFIG} -eq 0 ]; then
    set -- "$@" --config "${CONFIG_PATH}"
fi

# 最后执行原本的程序启动命令
exec "$@"

最终用户使用方式 #

完成镜像构建后，用户可以自由选择配置方案：

• 使用默认配置启动，无需额外参数：

  docker run --rm -it -p 80:80 dockerhub/mydockerimage:v3
  

• 使用自定义配置启动，两种可选操作：
  1. 直接把本地配置挂载到默认的运行时配置路径：

  docker run --rm -it -v $(pwd)/自定义config.yml:/app/runtime-config.yml -p 80:80 dockerhub/mydockerimage:v3
  

  2. 挂载配置目录后通过--config参数指定配置路径，和你提到的常用用法一致：

  docker run --rm -it -v $(pwd):/data -p 80:80 dockerhub/mydockerimage:v3 --config /data/config.yml
  

注意：如果你的程序使用非root用户运行，需要提前给/app路径分配对应用户的读写权限，避免启动时报权限错误。

内容的提问来源于stack exchange，提问作者Devil's Dream