简介
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 directoryWORKDIR /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 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须要留神的事项。
- 不要应用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的博客
欢送关注我的公众号:「程序那些事」最艰深的解读,最粗浅的干货,最简洁的教程,泛滥你不晓得的小技巧等你来发现!