Docker卷部署文件同步需求：仅依赖docker-compose能否实现？

结论：仅靠docker-compose无法直接实现 #

默认的绑定挂载逻辑是：如果宿主机目录存在，直接使用宿主机的文件/目录；如果不存在，Docker会在宿主机创建空目录，但不会自动复制容器内的文件到宿主机。因此需要结合脚本或辅助容器来实现需求。

解决方案1：自定义Entrypoint脚本（推荐，适合修改镜像的场景） #

通过在容器启动前执行自定义脚本，完成默认配置的初始化，之后再启动主服务。

步骤1：调整Dockerfile #

将默认配置文件存入容器内的独立目录，并添加同步脚本：

# 以nginx镜像为例，替换为你的基础镜像
FROM nginx:alpine

# 创建容器内的默认配置存储目录
RUN mkdir -p /container-defaults
# 将本地默认配置文件复制到容器内的默认目录
COPY ./default-configs/* /container-defaults/

# 添加同步配置的脚本
COPY sync-configs.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/sync-configs.sh

# 设置entrypoint优先执行同步脚本
ENTRYPOINT ["sync-configs.sh"]
# 保留原容器的启动命令
CMD ["nginx", "-g", "daemon off;"]

步骤2：编写同步脚本sync-configs.sh #

脚本会检查挂载目录（宿主机映射过来的目录）中的文件，仅当文件不存在时，从容器内的默认目录复制过去：

#!/bin/sh

# 定义路径：容器内的默认配置目录、挂载的目标配置目录（对应宿主机/host-dir）
DEFAULT_CONFIG_DIR="/container-defaults"
TARGET_CONFIG_DIR="/container-dir"

# 确保目标目录存在
mkdir -p "$TARGET_CONFIG_DIR"

# 遍历默认配置文件，仅复制目标目录中不存在的文件
for file in "$DEFAULT_CONFIG_DIR"/*; do
    filename=$(basename "$file")
    if [ ! -f "$TARGET_CONFIG_DIR/$filename" ]; then
        cp -a "$file" "$TARGET_CONFIG_DIR/"
        echo "初始化默认配置文件：$filename"
    fi
done

# 执行容器的主服务命令
exec "$@"

步骤3：修改docker-compose.yml #

保持原有的卷挂载配置即可：

my-service:
  container_name: my-container
  build: ./path-to-your-dockerfile  # 指向包含上述Dockerfile的目录
  # 其他配置（端口、环境变量等）
  ...
  volumes:
    - /host-dir:/container-dir

解决方案2：使用Init容器（适合不修改主镜像的场景） #

通过一个临时的初始化容器，在主服务启动前完成配置文件的同步，无需修改原有服务镜像。

docker-compose.yml配置示例 #

version: '3.8'

services:
  # 初始化配置的临时容器
  init-config:
    image: alpine:latest
    # 执行同步命令：检查宿主机目录，不存在则复制默认配置
    command: >
      sh -c "
      mkdir -p /host-dir;
      for file in /container-defaults/*; do
        filename=\$(basename \$file);
        if [ ! -f /host-dir/\$filename ]; then
          cp -a \$file /host-dir/;
        fi
      done
      "
    volumes:
      - /host-dir:/host-dir  # 挂载宿主机目录到init容器
      - ./default-configs:/container-defaults  # 本地默认配置目录挂载到init容器

  # 主服务容器
  my-service:
    container_name: my-container
    image: your-existing-service-image  # 使用你原有的服务镜像
    # 其他配置
    ...
    volumes:
      - /host-dir:/container-dir
    # 依赖init容器，确保配置同步完成后再启动
    depends_on:
      init-config:
        condition: service_completed_successfully

两种方案的适用场景 #

• Entrypoint脚本方案：适合你有权限修改服务镜像的场景，集成度更高，容器启动流程更简洁。
• Init容器方案：适合无法修改原有服务镜像的场景，通过独立容器完成初始化，对主服务无侵入。

两种方案都能完全适配CI/CD流水线，实现自动化部署，无需人工干预配置文件的初始化。

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