简介

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 directoryWORKDIR /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 directoryWORKDIR /data/appCOPY 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# ExampleREPOSITORY                      TAG        ID              CREATEDnode                            12         1934b0b038d1    5 days agoflydean/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的博客

欢送关注我的公众号:「程序那些事」最艰深的解读,最粗浅的干货,最简洁的教程,泛滥你不晓得的小技巧等你来发现!