2.7 KiB
node-backend 示例
演示如何用 compile-node22 + runtime-node22 两阶段构建一个 Node.js 22 Web 服务。只用 Node 内置 http 模块,
无第三方依赖(npm install 不会真的下载东西),但依赖层写法按真实项目留好了。
| 阶段 | 镜像 | 说明 |
|---|---|---|
| 编译 | registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-node22 |
Node + npm(源为 npmmirror)+ node-gyp 所需 python3/gcc |
| 运行 | registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-node22 |
仅 Node 运行时 |
示例内容
node-backend/
├── package.json # 无依赖;engines.node >= 20
├── server.js # 内置 http:/、/api/info、/health、/api/hello、/page,带 SIGTERM 优雅关闭
├── Dockerfile # 两阶段:compile-node22 -> runtime-node22
├── build.sh # 构建镜像(PUSH=1 时同时推送)
├── docker-compose.yml # 部署编排(端口 8087,固定 IP 172.31.1.20)
├── startup.sh # docker-compose up -d
└── shutdown.sh # docker-compose down
构建与部署
sh build.sh # docker build -t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-node-backend .
PUSH=1 sh build.sh # 构建并推送
sh startup.sh # docker-compose -f docker-compose.yml -p node-backend-demo up -d
访问:
curl http://127.0.0.1:8087/ # {"message":"node demo is running","node":"v22.x.x",...}
curl http://127.0.0.1:8087/health # ok
curl http://127.0.0.1:8087/api/hello?name=demo
浏览器打开 http://127.0.0.1:8087/page 可看到 HTML 页面。
关键点
依赖层缓存:先 COPY package.json package-lock.json* 执行 npm install --omit=dev,再 COPY 源码。
源码改动不会让依赖安装层失效。本示例 package.json 里没有任何依赖,npm 不会创建 node_modules,
所以 Dockerfile 先判断有没有 dependencies/devDependencies 再决定是否安装——换成 express 等项目时加依赖即可,
Dockerfile 不用改。
运行镜像只拷产物:运行阶段分别 COPY --from=build 拷 package.json、node_modules(可选)与 server.js,
不额外收集到 /out 目录,避免“无依赖时目录不存在”导致构建失败。
构建期自检:node --check server.js 让语法错误在构建阶段就失败,而不是等容器启动。
优雅关闭:ENTRYPOINT ["node", ...] 让 node 成为 PID 1 直接收到 docker stop 的 SIGTERM;
server.js 里 server.close() 后退出,10 秒兜底强制退出。
端口与 NODE_ENV:8087,NODE_ENV=production 在 Dockerfile 与 compose 中都设置。
停止
sh shutdown.sh