使用nodejs构建Docker image最佳实践

简介

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文件。

1. 引入base image。

为了运行docker程序，咱们须要指定一个基本的image，好比操做系统，node为咱们提供了一个封装好的image，咱们能够直接引用：

FROM node:12

咱们指定了node的12版本，这个版本已经安装好了最新的LTS node 12，使用这个image咱们就能够不须要本身来安装node的相关环境，很是的方便。

1. 指定工做目录

有了image，接下来就须要咱们指定docker中的工做目录：

# Create app directory
WORKDIR /data/app

1. 安装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。

1. 拷贝应用程序并运行

最后的工做就是拷贝应用程序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须要注意的事项。

1. 不要使用root用户来运行应用程序

默认状况下，docker中的应用程序会以root用户来运行，为了安全起见，建议你们以普通用户来运行应用程序，咱们能够在docker file中指定：

FROM node:12
...
# 在最后，以node用户来运行应用程序
USER node

或者咱们在运行的时候以 -u "node" 做为启动参数来指定运行的用户。

docker run \
  -u "node"
  flydean/koa-web-app

1. 指定运行时候的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的博客

欢迎关注个人公众号:「程序那些事」最通俗的解读，最深入的干货，最简洁的教程，众多你不知道的小技巧等你来发现！