簡介
docker容器的出現，徹底的改變了應用程序的運行方式，而nodejs同樣的也顛覆了后端應用程序的開發模式。兩者結合起來，就會產生意想不到的作用。
本文將會以一個常用的nodejs程序為例，分析怎么使用docker來構建nodejs image.
准備nodejs應用程序
一個標准的nodejs程序，需要一個package.json文件來描述應用程序的元數據和依賴關系，然后通過npm install來安裝應用的依賴關系，最后通過node app.js來運行程序。
本文將會創建一個簡單的koa應用程序，來說明docker的使用。
首先創建package.json文件：
{
"name": "koa-docker",
"description": "怎么將nodejs koa程序打包成docker應用",
"version": "0.0.1",
"dependencies": {
"ejs": "^2.5.6",
"fs-promise": "^2.0.3",
"koa": "^2.2.0",
"koa-basic-auth": "^2.0.0",
"koa-body": "^4.0.8",
"koa-compose": "^4.0.0",
"koa-csrf": "^3.0.6",
"koa-logger": "^3.0.0",
"@koa/router": "^8.0.5",
"koa-session": "^5.0.0",
"koa-static": "^3.0.0",
"koa-views": "^6.0.2"
},
"scripts": {
"test": "NODE_ENV=test mocha --harmony --reporter spec --require should */test.js",
"lint": "eslint ."
},
"engines": {
"node": ">= 7.6"
},
"license": "MIT"
}
上面的package.json文件制定了項目的依賴。
接下來，我們需要使用npm install來安裝項目的依賴，安裝好的項目依賴文件將會放在本地的node_modules文件夾中。
然后我們就可以編寫服務程序了：
const Koa = require('koa');
const app = module.exports = new Koa();
app.use(async function(ctx) {
ctx.body = 'Hello www.flydean.com';
});
if (!module.parent) app.listen(3000);
上面是一個非常簡單的koa服務端程序，監聽在3000端口，並且對每次請求都會返回‘Hello www.flydean.com’。
運行node app.js 我們就可以開啟web服務了。
好了，我們的服務程序搭建完畢，接下來，我們看一下docker打包nodejs程序的最佳實踐。
創建Dockerfile文件
為了創建docker image，我們需要一個Dockerfile文件，作為該image的描述。
我們一步一步的講解，如何創建這個Dockerfile文件。
- 引入base image。
為了運行docker程序，我們需要指定一個基本的image，比如操作系統，node為我們提供了一個封裝好的image，我們可以直接引用：
FROM node:12
我們指定了node的12版本，這個版本已經安裝好了最新的LTS node 12，使用這個image我們就可以不需要自己來安裝node的相關環境，非常的方便。
- 指定工作目錄
有了image，接下來就需要我們指定docker中的工作目錄：
# Create app directory
WORKDIR /data/app
- 安裝node_modules
接下來我們需要將package*.json文件拷貝進image中，並且運行npm install來安裝依賴庫：
COPY package*.json ./
RUN npm install
上面我們拷貝的是package*.json，因為如果我們本地運行過npm install命令的話，將會生成一個pacakge-lock.json文件。這個文件是為了統一依賴包版本用的。我們需要一並拷貝。
拷貝完之后就可以運行npm install來安裝依賴包了。
問題？為什么我們只拷貝了pacakge.json,而不是拷貝整個工作目錄呢？
回答：docker file中的每一個命令，都會導致創建一個新的layer，上面的docker file中，只要pakage.json沒有被修改，新創建的docker image其實是可以共享layer緩存的。
但是如果我們直接添加本地的工作目錄，那么只要我們的工作目錄有文件被修改，會導致整個docker image重新構建。所以為了提升構建效率和速度，我們只拷貝package.json。
- 拷貝應用程序並運行
最后的工作就是拷貝應用程序app.js然后運行了：
# 拷貝應用程序
COPY app.js .
# 暴露端口
EXPOSE 8080
# 運行命令
CMD [ "node", "app.js" ]
最后，我們的dockerfile文件應該是這樣的：
FROM node:12
# Create app directory
WORKDIR /data/app
COPY package*.json ./
RUN npm install
# 拷貝應用程序
COPY app.js .
# 暴露端口
EXPOSE 8080
# 運行命令
CMD [ "node", "app.js" ]
創建.dockerignore文件
我們知道git會有一個.gitignore文件，同樣的docker也有一個.dockerignore文件，這個文件的作用就是避免你的本地文件被拷貝到docker image中。
node_modules
比如我們可以在其中指定node_modules，使其不會被拷貝。
創建docker image
創建docker image很簡單，我們可以使用下面的命令：
docker build -t flydean/koa-web-app .
創建完畢之后，我們可以使用docker images來查看剛剛創建好的image :
docker images
# Example
REPOSITORY TAG ID CREATED
node 12 1934b0b038d1 5 days ago
flydean/koa-web-app latest d64d3505b0d2 1 minute ago
運行docker程序
最后，我們可以通過docker run命令來運行應用程序
docker run -p 54321:8080 -d flydean/koa-web-app
然后我們就可以通過本地的54321端口來訪問應用程序了。
node的docker image需要注意的事項
這里我們來探討一下創建docker image需要注意的事項。
- 不要使用root用戶來運行應用程序
默認情況下，docker中的應用程序會以root用戶來運行，為了安全起見，建議大家以普通用戶來運行應用程序，我們可以在docker file中指定：
FROM node:12
...
# 在最后，以node用戶來運行應用程序
USER node
或者我們在運行的時候以 -u "node" 作為啟動參數來指定運行的用戶。
docker run \
-u "node"
flydean/koa-web-app
- 指定運行時候的NODE_ENV
node的應用程序很多時候需要依賴於NODE_ENV來指定運行時環境，我們可以以參數的形式傳遞給docker run命令：
docker run \
-e "NODE_ENV=production"
flydean/koa-web-app
本文作者：flydean程序那些事
本文鏈接：http://www.flydean.com/nodejs-docker-best-practices/
本文來源：flydean的博客
歡迎關注我的公眾號:「程序那些事」最通俗的解讀，最深刻的干貨，最簡潔的教程，眾多你不知道的小技巧等你來發現！