Dockerfile中RUN创建的共享卷文件在CMD阶段消失，如何不合并CMD实现持久化？

根本原因 #

这是Docker镜像构建和容器启动的阶段差异导致的：

• RUN指令属于镜像构建阶段执行的逻辑，此时docker-compose.yml中配置的卷挂载完全不会生效，你通过RUN写入/usr/src/app/persist的文件实际是存储在镜像层的对应路径下
• 容器启动时会先执行卷挂载逻辑，宿主机的./hostpersist目录会直接覆盖容器内的/usr/src/app/persist路径，镜像层中该路径下的所有文件都会被挂载的目录遮挡，自然就看不到了
• 你把两个脚本都放在CMD中可以正常运行，是因为CMD属于容器启动阶段的逻辑，执行时卷已经挂载完成，写入的内容会直接落到挂载的宿主机目录中，不会被覆盖。

解决方案1：使用Entrypoint脚本处理初始化（推荐） #

把初始化逻辑放到Entrypoint脚本中，Entrypoint会在容器启动时、CMD执行前运行，此时卷已经完成挂载，写入的内容会持久化到卷中。
操作步骤：

1. 项目根目录新建entrypoint.sh文件，内容如下：

#!/bin/sh
# 执行初始化逻辑
node migrate.js
# 执行Dockerfile中指定的CMD指令
exec "$@"

2. 修改Dockerfile，添加Entrypoint相关配置：

...
WORKDIR /usr/src/app
...
# 拷贝entrypoint脚本到容器内
COPY entrypoint.sh .
# 给脚本加执行权限
RUN chmod +x entrypoint.sh
# 指定Entrypoint
ENTRYPOINT ["./entrypoint.sh"]
# 原来的CMD保持不变
CMD [ "node", "index.js" ]

这个方案不会改动原有业务逻辑，也不需要把所有指令都塞到CMD里，后续如果要加其他初始化逻辑，直接往entrypoint.sh里加即可。

解决方案2：预生成默认文件+启动时按需拷贝（适合初始化只需执行一次的场景） #

如果你的migrate.js只是生成默认配置文件，不需要每次容器启动都重新执行，可以用这个方案减少启动耗时：

1. 镜像构建阶段执行node migrate.js，把生成的文件存到非挂载目录：

...
WORKDIR /usr/src/app
...
# 构建阶段生成默认文件，存到非挂载目录
RUN node migrate.js && mkdir -p /opt/default-persist && cp -r persist/* /opt/default-persist/
# 拷贝entrypoint脚本
COPY entrypoint.sh .
RUN chmod +x entrypoint.sh
ENTRYPOINT ["./entrypoint.sh"]
CMD [ "node", "index.js" ]

2. 修改entrypoint.sh，只有挂载的persist目录为空时才拷贝默认文件：

#!/bin/sh
# 判断persist目录是否为空，为空则拷贝默认文件
if [ -z "$(ls -A /usr/src/app/persist)" ]; then
  cp -r /opt/default-persist/* /usr/src/app/persist/
fi
exec "$@"

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