Node.js 指南(Docker化Node.js Web应用程序)
Docker化Node.js Web应用程序
此示例的目的是向你展示如何将Node.js应用程序放入Docker容器中,该指南旨在用于开发,而不用于生产部署,本指南还假设你有一个有效的Docker安装,并且基本了解Node.js应用程序的结构。
在本指南的第一部分中,我们将在Node.js中创建一个简单的Web应用程序,然后我们将为该应用程序构建一个Docker镜像,最后我们将该镜像作为容器运行。
Docker允许你将具有所有依赖关系的应用程序打包到一个称为容器的标准化单元中,用于软件开发,容器是Linux操作系统分离出的基础版本,镜像是你加载到容器中的软件。
创建Node.js应用程序
首先,创建一个所有文件都将存在于其中的新目录,在此目录中,创建一个描述你的应用及其依赖项的package.json
文件:
{ "name": "docker_web_app", "version": "1.0.0", "description": "Node.js on Docker", "author": "First Last <[email protected]>", "main": "server.js", "scripts": { "start": "node server.js" }, "dependencies": { "express": "^4.16.1" } }
使用新的package.json
文件,运行npm install
,如果你使用的是npm版本5或更高版本,则会生成一个package-lock.json
文件,该文件将被复制到你的Docker镜像中。
然后,创建一个使用Express.js
框架定义Web应用程序的server.js
文件:
'use strict'; const express = require('express'); // Constants const PORT = 8080; const HOST = '0.0.0.0'; // App const app = express(); app.get('/', (req, res) => { res.send('Hello world\n'); }); app.listen(PORT, HOST); console.log(`Running on http://${HOST}:${PORT}`);
在接下来的步骤中,我们将了解如何使用官方Docker镜像在Docker容器中运行此应用程序,首先,你需要构建应用程序的Docker镜像。
创建Dockerfile
创建一个名为Dockerfile
的空文件:
touch Dockerfile
在你喜欢的文本编辑器中打开Dockerfile
。
我们需要做的第一件事是定义我们想要构建的镜像,在这里,我们将使用Docker Hub提供的最新LTS(长期支持)版本8
node
:
FROM node:8
接下来,我们创建一个目录来保存镜像中的应用程序代码,这将是你的应用程序的工作目录:
# Create app directory WORKDIR /usr/src/app
这个镜像已经安装了Node.js和NPM,所以接下来我们需要做的是使用npm
二进制文件安装你的应用程序依赖项,请注意,如果你使用的是npm
版本4或更早版本,则不会生成package-lock.json
文件。
# Install app dependencies # A wildcard is used to ensure both package.json AND package-lock.json are copied # where available (npm@5+) COPY package*.json ./ RUN npm install # If you are building your code for production # RUN npm install --only=production
请注意,我们只复制package.json
文件,而不是复制整个工作目录,这使我们可以利用缓存的Docker层,bitJudo在这里有一个很好的解释。
要将应用程序的源代码捆绑在Docker镜像中,请使用COPY
指令:
# Bundle app source COPY . .
你的应用程序绑定到端口8080
,因此你将使用EXPOSE
指令让docker
守护程序映射它:
EXPOSE 8080
最后但并非最不重要的是,使用定义你运行时的CMD
定义运行你应用程序的命令,这里我们将使用基本的npm start
来运行node server.js
来启动你的服务器:
CMD [ "npm", "start" ]
你的Dockerfile
现在应该如下所示:
FROM node:8 # Create app directory WORKDIR /usr/src/app # Install app dependencies # A wildcard is used to ensure both package.json AND package-lock.json are copied # where available (npm@5+) COPY package*.json ./ RUN npm install # If you are building your code for production # RUN npm install --only=production # Bundle app source COPY . . EXPOSE 8080 CMD [ "npm", "start" ]
.dockerignore文件
在与Dockerfile
相同的目录中创建一个.dockerignore
文件,其中包含以下内容:
node_modules npm-debug.log
这样可以防止将本地模块和调试日志复制到Docker镜像上,并可能覆盖镜像中安装的模块。
构建你的镜像
转到具有Dockerfile
的目录,然后运行以下命令来构建Docker镜像,使用-t
标志可以标记镜像,以便以后使用docker images
命令更容易找到:
$ docker build -t <your username>/node-web-app .
你的镜像现在将由Docker列出:
$ docker images # Example REPOSITORY TAG ID CREATED node 8 1934b0b038d1 5 days ago <your username>/node-web-app latest d64d3505b0d2 1 minute ago
运行镜像
使用-d
运行镜像以分离模式运行容器,使容器在后台运行,-p
标志将公共端口重定向到容器内的私有端口,运行你之前构建的镜像:
$ docker run -p 49160:8080 -d <your username>/node-web-app
打印应用程序的输出:
# Get container ID $ docker ps # Print app output $ docker logs <container id> # Example Running on http://localhost:8080
如果你需要进入容器内部,你可以使用exec
命令:
# Enter the container $ docker exec -it <container id> /bin/bash
测试
要测试你的应用程序,请获取Docker映射的应用端口:
$ docker ps # Example ID IMAGE COMMAND ... PORTS ecce33b30ebf <your username>/node-web-app:latest npm start ... 49160->8080
在上面的示例中,Docker将容器内部的8080
端口映射到计算机上的端口49160
。
现在,你可以使用curl
调用你的应用程序(如果需要,请通过以下方式安装:sudo apt-get install curl
):
$ curl -i localhost:49160 HTTP/1.1 200 OK X-Powered-By: Express Content-Type: text/html; charset=utf-8 Content-Length: 12 ETag: W/"c-M6tWOb/Y57lesdjQuHeB1P/qTV0" Date: Mon, 13 Nov 2017 20:53:59 GMT Connection: keep-alive Hello world
我们希望本教程可以帮助你在Docker上启动并运行一个简单的Node.js应用程序。
你可以在以下位置找到有关Docker和Node.js的更多信息: