如何使用 Docker 高效部署 Node 應(yīng)用
❝ 如何在生產(chǎn)環(huán)境部署一個 Node 應(yīng)用?[1]❞
一個合理并且高效的部署方案，不僅能夠?qū)崿F(xiàn)快速升級，平滑切換，負(fù)載均衡，應(yīng)用隔離等部署特性，而且配有一套成熟穩(wěn)定的監(jiān)控。
kubernetes 把 Node 應(yīng)用視作一個服務(wù)端應(yīng)用的黑盒子，完美匹配了以上條件，越來越多的團(tuán)隊(duì)把 node 部署在 k8s 上。
但在此之前，需要先把 Node 應(yīng)用跑在一個 Docker 容器上，這也是本章的主題。
一個簡單的 Node 應(yīng)用
「index.js」
一個 hello, world 版的 Node Web App
- const http = require('http')
- const app = async (req, res) => {
- res.end('hello, world')
- }
- http.createServer(app).listen(3000, () => console.log(3000))
「package.json」
配置 npm start 來啟動應(yīng)用
- "scripts": {
- "start": "node index.js"
- },
但這僅僅是最簡單的 Node 應(yīng)用，真實(shí)環(huán)境中還有各種數(shù)據(jù)存儲及定時任務(wù)調(diào)度等，暫撇開不談，這已經(jīng)足夠了。
再稍微復(fù)雜一點(diǎn)點(diǎn)的 Node 應(yīng)用可以查看山月的項(xiàng)目 whoami[5]: 一個最簡化的 serverless 與 dockerize 示例。
NODE_ENV=production
在生產(chǎn)環(huán)境中，無需安裝 devDependecies 中依賴，NODE_ENV 環(huán)境變量設(shè)置為 production 時將會跳過 devDep。
- # 通過設(shè)置環(huán)境變量，只安裝生產(chǎn)環(huán)境依賴
- $ NODE_ENV=production npm ci
- # 通過顯式指定 flag，只安裝生產(chǎn)環(huán)境依賴
- $ npm ci --production
另一方面，某些第三方模塊會根據(jù) NODE_ENV 環(huán)境變量做出一些意料不到的配置。因此在生產(chǎn)環(huán)境注意該環(huán)境變量的配置。
一個 Node 應(yīng)用的簡單部署
一個典型的、面向服務(wù)端的 Node 應(yīng)用是這么跑起來的:
- npm install
- npm run config，從配置服務(wù)(consul/vault)拉取配置 ，如數(shù)據(jù)庫與緩存的賬號密碼，此時構(gòu)建服務(wù)器需要配置服務(wù)權(quán)限
- npm run migrate，數(shù)據(jù)庫遷移腳本，執(zhí)行數(shù)據(jù)庫表列行更改操作，此時構(gòu)建服務(wù)器需要數(shù)據(jù)庫訪問權(quán)限
- npm start，啟動一個 Node 服務(wù)
把運(yùn)行步驟翻譯為 Dockerfile:
- # 選擇一個體積小的鏡像 (~5MB)
- FROM node:12-alpine
- # 環(huán)境變量設(shè)置為生產(chǎn)環(huán)境
- ENV NODE_ENV production
- WORKDIR /code
- # 更好的根據(jù) Image Layer 利用緩存
- ADD package.json package-lock.json /code
- RUN npm ci
- ADD . /code
- # 配置服務(wù)及數(shù)據(jù)庫遷移
- RUN npm run config --if-present && npm run migrate --if-present
- EXPOSE 3000
- CMD npm start
這對于大部分 Node 應(yīng)用已經(jīng)是足夠了，如果精益求精，可以再走接下來的多階段構(gòu)建
node-gyp 與 Native Addon
在 Node 中有可能存在著一些 Native Addon，它們通過 node-gyp 進(jìn)行編譯，而它依賴于 python，make 與 g++。
- $ apk --no-cache add python make g++
在帶有編譯過程的鏡像構(gòu)建中，源文件與構(gòu)建工具都會造成空間的浪費(fèi)。借助鏡像的「多階段構(gòu)建」可以高效利用空間。Go App 與 FE App 的構(gòu)建也遵循此規(guī)則。
- 多階段構(gòu)建 Go 應(yīng)用[6]
- 多階段構(gòu)建前端應(yīng)用[7]
在構(gòu)建 Node 應(yīng)用鏡像時，第一層鏡像用以構(gòu)造 node_modules。
- # 選擇一個體積小的鏡像 (~5MB)
- FROM node:12-alpine as builder
- # 環(huán)境變量設(shè)置為生產(chǎn)環(huán)境
- ENV NODE_ENV production
- # 更好的根據(jù) Image Layer 利用緩存
- ADD package.json package-lock.json ./
- RUN npm ci
- # 多階段構(gòu)建之第二階段
- # 多階段構(gòu)建之第二階段
- # 多階段構(gòu)建之第二階段
- FROM node:12-alpine
- WORKDIR /code
- ENV NODE_ENV production
- ADD . .
- COPY --from=builder node_modules node_modules
- # 配置服務(wù)及數(shù)據(jù)庫遷移
- RUN npm run config --if-present && npm run migrate --if-present
- EXPOSE 3000
- CMD npm start
相關(guān)文章
- N-API and getting started with writing C addons for Node.js[8]
- Using Docker for Node.js in Development and Production[9]
Reference
[1]如何在生產(chǎn)環(huán)境部署一個 Node 應(yīng)用？:
https://github.com/shfshanyue/Daily-Question/issues/420
[2]如何在 docker 中部署前端:
https://shanyue.tech/frontend-engineering/docker.html
[3]前端部署 Prview 與 Production:
https://shanyue.tech/frontend-engineering/feature-deploy.html
[4]前端部署的發(fā)展過程:
https://shanyue.tech/frontend-engineering/deploy.html
[5]whoami:
https://github.com/shfshanyue/whoami
[6]多階段構(gòu)建 Go 應(yīng)用:
https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
[7]多階段構(gòu)建前端應(yīng)用:
https://shanyue.tech/frontend-engineering/docker.html#%E5%A4%9A%E9%98%B6%E6%AE%B5%E6%9E%84%E5%BB%BA
[8]N-API and getting started with writing C addons for Node.js:
https://hackernoon.com/n-api-and-getting-started-with-writing-c-addons-for-node-js-cf061b3eae75
[9]Using Docker for Node.js in Development and Production:
https://dev.to/alex_barashkov/using-docker-for-nodejs-in-development-and-production-3cgp
