基于S2I的Node.js应用热部署开发工作流如何正确配置？

核心思路 #

要解决宿主机代码同步与容器内node_modules依赖保留的矛盾，关键是同时实现宿主机代码目录绑定挂载，且单独保留容器内的依赖目录不被覆盖，结合S2I的DEV_MODE特性完成热部署。

具体步骤 #

1. 构建包含完整依赖的S2I开发镜像
   先使用官方Node.js S2I镜像构建基础镜像，这个过程会自动安装package.json中的依赖到容器内的/app/node_modules：

   s2i build . registry.redhat.io/rhscl/nodejs-18-rhel8 my-node-dev-app
   

   替换其中的S2I基础镜像为你使用的Node.js版本镜像（比如quay.io/sclorg/nodejs-20-c9s），最后一个参数是自定义的镜像名称。

2. 启动容器时配置双挂载+DEV_MODE
   启动容器时需要做两个挂载操作，同时开启DEV_MODE=true：

   docker run -d \
     -p 3000:3000 \
     -e DEV_MODE=true \
     --mount type=bind,source=$(pwd),target=/app \
     --mount type=volume,source=node-modules-vol,target=/app/node_modules \
     my-node-dev-app
   

   • --mount type=bind：把宿主机当前代码目录挂载到容器内的应用目录/app，实现宿主机代码修改实时同步到容器。
   • --mount type=volume：创建一个命名卷node-modules-vol，第一次启动时会自动从容器内已安装的node_modules初始化，后续运行时该目录会独立于绑定挂载，避免被宿主机目录覆盖，保证依赖可用。
   • DEV_MODE=true：触发S2I启动nodemon监听容器内/app目录的文件变化，宿主机同步过来的修改会被即时检测到并重启应用。

注意事项 #

• 如果修改了package.json（新增/删除依赖），需要重新构建S2I镜像，或者进入容器执行npm install后重启，确保命名卷内的依赖更新。
• 若使用OpenShift集群开发，对应配置需在Deployment/DeploymentConfig中设置：
  • 添加一个PersistentVolumeClaim作为node_modules的存储卷
  • 添加hostPath类型的卷挂载宿主机代码目录（仅适用于单节点开发集群）
  • 环境变量中设置DEV_MODE=true

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