中国领先的IT技术网站
|
|

基于 Docker 开发 NodeJS 应用

这是两篇文章的第一篇。本文涵盖了有关在使用Express框架开发一个Node应用时,用Docker 替代Vagrant 的比较详细的教程, 应用将使用 connect-redis 中间件将会话信息持久化到Redis中……

作者:来源:开源中国社区 编译|2014-07-29 10:35

开发者大赛路演 | 12月16日,技术创新,北京不见不散


这是两篇文章的第一篇。本文涵盖了有关在使用Express框架开发一个Node应用时,用Docker 替代Vagrant 的比较详细的教程, 应用将使用 connect-redis 中间件将会话信息持久化到Redis中. 第二篇文章将介绍到将这个开发的设置产品化.

有关这个 Node 应用

此应用包含一个 package.json, server.js 以及一个 .gitignore 文件, 它们简单到可以信手拈来.

.gitignore

  1. node_modules/* 

package.json

  1. {  
  2.     "name""docker-dev",  
  3.     "version""0.1.0",  
  4.     "description""Docker Dev",  
  5.     "dependencies": {  
  6.         "connect-redis""~1.4.5",  
  7.         "express""~3.3.3",  
  8.         "hiredis""~0.1.15",  
  9.         "redis""~0.8.4" 
  10.     }  

server.js

  1. var express = require('express'),  
  2.     app = express(),  
  3.     redis = require('redis'),  
  4.     RedisStore = require('connect-redis')(express),  
  5.     server = require('http').createServer(app);  
  6.    
  7. app.configure(function() {  
  8.   app.use(express.cookieParser('keyboard-cat'));  
  9.   app.use(express.session({  
  10.         store: new RedisStore({  
  11.             host: process.env.REDIS_HOST || 'localhost',  
  12.             port: process.env.REDIS_PORT || 6379,  
  13.             db: process.env.REDIS_DB || 0  
  14.         }),  
  15.         cookie: {  
  16.             expires: false,  
  17.             maxAge: 30 * 24 * 60 * 60 * 1000  
  18.         }  
  19.     }));  
  20. });  
  21.    
  22. app.get('/'function(req, res) {  
  23.   res.json({  
  24.     status: "ok" 
  25.   });  
  26. });  
  27.    
  28. var port = process.env.HTTP_PORT || 3000;  
  29. server.listen(port);  
  30. console.log('Listening on port ' + port); 

server.js 会拉取所有的依赖并启动一个特定的应用. 这个特定的应用被设定成将会话信息存储到Redis中,并暴露出一个请求端点,其会响应返回一个JSON的状态消息. 这都是非常标准的东西.

需要注意的一件事情就是针对Redis的连接信息可以使用环境变量重写——这将会在稍后从开发环境dev迁移到生产环境prod时起到作用.

Dockerfile

为了开发的需要,我们将会让Redis和Node在同一个容器中运行。为此,我们将使用一个Dockerfile来配置这个容器。

Dockerfile

  1. FROM dockerfile/ubuntu  
  2.    
  3. MAINTAINER Abhinav Ajgaonkar <abhinav316@gmail.com>  
  4.    
  5. # Install Redis  
  6. RUN   \  
  7.   apt-get -y -qq install python redis-server  
  8.    
  9. # Install Node  
  10. RUN   \  
  11.   cd /opt && \  
  12.   wget http://nodejs.org/dist/v0.10.28/node-v0.10.28-linux-x64.tar.gz && \  
  13.   tar -xzf node-v0.10.28-linux-x64.tar.gz && \  
  14.   mv node-v0.10.28-linux-x64 node && \  
  15.   cd /usr/local/bin && \  
  16.   ln -s /opt/node/bin/* . && \  
  17.   rm -f /opt/node-v0.10.28-linux-x64.tar.gz  
  18.    
  19. # Set the working directory  
  20. WORKDIR   /src  
  21.    
  22. CMD ["/bin/bash"

我们一行一行的来理解,

  1. FROM dockerfile/ubuntu 

这回告诉docker要使用Docker Inc. 提供的 dockerfile/ubuntu 镜像. 作为构建的基准镜像.

  1. RUN  \  
  2.   apt-get -y -qq install python redis-server 

基准镜像完全没有包含任何东西——因此我们需要使用apt-get来获取应用运行起来所需的所有东西. 这一句会安装python 和 redis-server. Redis 服务器是必须的,因为我们将会把会话信息存储到它之中,而python的必要性则是通过npm可以构建为Redis node模块所需的C扩展.

  1. RUN  \  
  2.   cd /opt && \  
  3.   wget http://nodejs.org/dist/v0.10.28/node-v0.10.28-linux-x64.tar.gz && \  
  4.   tar -xzf node-v0.10.28-linux-x64.tar.gz && \  
  5.   mv node-v0.10.28-linux-x64 node && \  
  6.   cd /usr/local/bin && \  
  7.   ln -s /opt/node/bin/* . && \  
  8.   rm -f /opt/node-v0.10.28-linux-x64.tar.gz 

这会下载并提取64位的NodeJS二进制文件.

  1. WORKDIR  /src 

这句会告诉docker一旦容器已经启动,在执行CMD属性指定的东西之前,要做一次 cd /src.

  1. CMD ["/bin/bash"] 

作为最后一步,运行 /bin/bash.

构建并运行容器

现在docker文件写好了,让我们来构建一个Docker镜像吧.

  1. docker build -t sqldump/docker-dev:0.1 . 

一旦把镜像构建好了,我们就可以使用下面的语句运行一个容器了:

  1. docker run -i -t --rm \  
  2.            -p 3000:3000 \  
  3.            -v `pwd`:/src \  
  4.            sqldump/docker-dev:0.1 

让我们来看一看docker运行命令中发生了什么.

-i 会在交互模式下启动容器(对比 -d 是在分离模式下). 这就意味一旦交互会话结束,容器就会退出.

-t 会分配一个pseudo-tty.

--rm 会在退出时移除容器及其文件系统.

-p 3000:3000 会将主机上的端口 3000 转发到容器上的端口3000.

  1. -v `pwd`:/src 

这句将会将当前的工作目录挂载到主机上(例如,我们的项目文件)容器中的 /src 里面. 我们将当前目录作为一个卷挂在,而不是使用Dockerfile中的ADD命令,那样我们在文本编辑器中做的任何修改都可以立即在容器中看到了.

sqldump/docker-dev:0.1 是要运行的docker镜像的名称和版本 – 这跟我们用来构建docker镜像时使用的名称和版本是相同的.

由于Dockerfile指定了CMD ["/bin/bash"], 容器一启动,我们就会登录到一个bash shell环境中. 如果docker运行命令执行成功了,就会像下面这样:

开始开发
 

现在容器是运行起来了,在开始写代码之前,我们将需要整理出一些标准的,非docker相关的东西. 首先,要使用下面的语句启动容器里面的redis服务器:

  1. service redis-server start 

然后,要安装项目依赖和nodemon. Nodemon 会观察项目文件中的变更,并适时重启服务器.

  1. npm install  
  2. npm install -g nodemon 

最后,使用如下命令启动服务器:

  1. nodemon server.js 

现在,如果你在浏览器中导航到 http://localhost:3000, 你应该会看到像下面这样的东西:

让我们来像Server.js中加入另外一个端点,以模拟开发流程:

  1. app.get('/hello/:name', function(req, res) {  
  2.   res.json({  
  3.     hello: req.params.name  
  4.   });  
  5. }); 

你会看到nodemon已经侦测到了你所做的修改,并重启了服务器:

而现在,如果你将浏览器导航到http://localhost:3000/hello/world, 你会看到如下的响应:

生产环境

当前状态下的容器,还远不能作为产品发布.redis中的数据不会再跨容器重启时仍然保持持久化, 比方说,如果你重启了容器,所有的会话数据就都灰飞烟灭了. 同样的事情在你销毁容器并开启一个的新的容器时也会发生,明显这不是你想要的。我将会在第二部分的产品化内容中讲到这个问题.

英文原文:Develop a NodeJS App With Docker

译文链接:http://www.oschina.net/translate/develop-a-nodejs-app-with-docker

【编辑推荐】

  1. 谷歌拥抱Docker 最火的云计算技术
  2. 开源软件部署解决方案 Docker 1.0 正式发布
  3. Docker迈入云(DockerHub)端(Docker引擎)时代
  4. DockerCon 上露脸的开源项目
  5. 在Docker上建立多节点的Hadoop集群
【责任编辑:林师授 TEL:(010)68476606】

点赞 0
分享:
大家都在看
猜你喜欢

读 书 +更多

Eclipse从入门到精通(第2版)

本书为《Eclipse从入门到精通》一书的全新改版。本书以最新的Eclipse 3.2作为写作版本。全书分为5篇:起步篇介绍了Eclipse及相关插件的安装...

订阅51CTO邮刊

点击这里查看样刊

订阅51CTO邮刊
× 51CTO学院双十二活动