如何将Docker镜像初始文件同步至K8s共享持久化卷（如NFS）？

问题场景 #

你有一个Web应用的Docker镜像，运行时依赖目录/usr/local/myapp，目录结构如下：

/usr/local/myapp/
                    conf/
                        foo.xml
                    web-files/
                        index.html
                        images/

在单机Docker环境中，挂载空卷到该目录时，镜像内的初始文件会自动同步到卷中；但在Kubernetes里直接将NFS共享卷挂载到/usr/local/myapp时，镜像原有文件会被卷隐藏，既无法访问也不会同步到共享卷。以下是几种可行的解决方案：

方案1：用初始化容器（Init Container）同步文件 #

初始化容器会在业务容器启动前运行，专门负责将镜像内的初始文件复制到共享卷中，避免挂载卷时覆盖原有文件。

示例Deployment配置 #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my_web
spec:
  template:
    spec:
      # 初始化容器：负责同步初始文件到共享卷
      initContainers:
        - name: sync-init-files
          image: my-web-app:1.0
          # 仅在共享卷为空时复制文件，避免覆盖已有内容
          command: ["sh", "-c", "if [ -z \"$(ls -A /mnt/myapp)\" ]; then cp -r /usr/local/myapp/. /mnt/myapp/; fi"]
          volumeMounts:
            - name: my-volume
              mountPath: /mnt/myapp
      # 业务容器：正常挂载共享卷到目标目录
      containers:
        - image: my-web-app:1.0
          volumeMounts:
            - name: my-volume
              mountPath: /usr/local/myapp
      volumes:
        - name: my-volume
          persistentVolumeClaim:
            claimName: my-pv-claim

说明：如果需要强制覆盖共享卷内的文件，可去掉判断逻辑，直接执行cp -r /usr/local/myapp/. /mnt/myapp/。

方案2：修改应用启动脚本，启动时自动同步 #

如果不想新增初始化容器，可以在应用的启动脚本中加入同步逻辑，每次容器启动时检查共享卷内容，缺失则从镜像内的备份目录复制。

步骤1：改造Docker镜像 #

修改Dockerfile，将原/usr/local/myapp目录备份到镜像内的其他路径，同时替换启动脚本：

FROM my-web-app:1.0
# 备份镜像内的初始文件目录
RUN cp -r /usr/local/myapp /usr/local/myapp-template
# 添加自定义启动脚本
COPY start-app.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/start-app.sh
CMD ["start-app.sh"]

步骤2：编写启动脚本start-app.sh #

#!/bin/bash
# 检查共享卷目录是否为空，为空则同步初始文件
if [ -z "$(ls -A /usr/local/myapp)" ]; then
  cp -r /usr/local/myapp-template/. /usr/local/myapp/
fi
# 启动Web应用
exec your-web-app-start-command

步骤3：正常部署Kubernetes资源 #

直接使用原Deployment配置挂载共享卷到/usr/local/myapp即可，容器启动时会自动完成文件同步。

方案3：使用临时卷中转（解决多副本同步冲突） #

如果是多副本场景，担心多个初始化容器同时写入共享卷导致冲突，可以先将初始文件同步到emptyDir临时卷，再由单个初始化容器统一复制到共享卷。这种方案相对复杂，仅在特殊场景下使用。

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