基于 Docker 開發(fā) NodeJS 應(yīng)用
這是兩篇文章的***篇。本文涵蓋了有關(guān)在使用Express框架開發(fā)一個Node應(yīng)用時，用Docker 替代Vagrant 的比較詳細(xì)的教程, 應(yīng)用將使用 connect-redis 中間件將會話信息持久化到Redis中. 第二篇文章將介紹到將這個開發(fā)的設(shè)置產(chǎn)品化.
有關(guān)這個 Node 應(yīng)用
此應(yīng)用包含一個 package.json, server.js 以及一個 .gitignore 文件, 它們簡單到可以信手拈來.
.gitignore
- node_modules/*
package.json
- {
- "name": "docker-dev",
- "version": "0.1.0",
- "description": "Docker Dev",
- "dependencies": {
- "connect-redis": "~1.4.5",
- "express": "~3.3.3",
- "hiredis": "~0.1.15",
- "redis": "~0.8.4"
- }
- }
server.js
- var express = require('express'),
- app = express(),
- redis = require('redis'),
- RedisStore = require('connect-redis')(express),
- server = require('http').createServer(app);
- app.configure(function() {
- app.use(express.cookieParser('keyboard-cat'));
- app.use(express.session({
- store: new RedisStore({
- host: process.env.REDIS_HOST || 'localhost',
- port: process.env.REDIS_PORT || 6379,
- db: process.env.REDIS_DB || 0
- }),
- cookie: {
- expires: false,
- maxAge: 30 * 24 * 60 * 60 * 1000
- }
- }));
- });
- app.get('/', function(req, res) {
- res.json({
- status: "ok"
- });
- });
- var port = process.env.HTTP_PORT || 3000;
- server.listen(port);
- console.log('Listening on port ' + port);
server.js 會拉取所有的依賴并啟動一個特定的應(yīng)用. 這個特定的應(yīng)用被設(shè)定成將會話信息存儲到Redis中，并暴露出一個請求端點(diǎn)，其會響應(yīng)返回一個JSON的狀態(tài)消息. 這都是非常標(biāo)準(zhǔn)的東西.
需要注意的一件事情就是針對Redis的連接信息可以使用環(huán)境變量重寫——這將會在稍后從開發(fā)環(huán)境dev遷移到生產(chǎn)環(huán)境prod時起到作用.
Dockerfile
為了開發(fā)的需要，我們將會讓Redis和Node在同一個容器中運(yùn)行。為此，我們將使用一個Dockerfile來配置這個容器。
Dockerfile
- FROM dockerfile/ubuntu
- MAINTAINER Abhinav Ajgaonkar <abhinav316@gmail.com>
- # Install Redis
- RUN \
- apt-get -y -qq install python redis-server
- # Install Node
- RUN \
- cd /opt && \
- wget http://nodejs.org/dist/v0.10.28/node-v0.10.28-linux-x64.tar.gz && \
- tar -xzf node-v0.10.28-linux-x64.tar.gz && \
- mv node-v0.10.28-linux-x64 node && \
- cd /usr/local/bin && \
- ln -s /opt/node/bin/* . && \
- rm -f /opt/node-v0.10.28-linux-x64.tar.gz
- # Set the working directory
- WORKDIR /src
- CMD ["/bin/bash"]
我們一行一行的來理解,
- FROM dockerfile/ubuntu
這回告訴docker要使用Docker Inc. 提供的 dockerfile/ubuntu 鏡像. 作為構(gòu)建的基準(zhǔn)鏡像.
- RUN \
- apt-get -y -qq install python redis-server
基準(zhǔn)鏡像完全沒有包含任何東西——因此我們需要使用apt-get來獲取應(yīng)用運(yùn)行起來所需的所有東西. 這一句會安裝python 和 redis-server. Redis 服務(wù)器是必須的，因?yàn)槲覀儗褧捫畔⒋鎯Φ剿?，而python的必要性則是通過npm可以構(gòu)建為Redis node模塊所需的C擴(kuò)展.
- RUN \
- cd /opt && \
- wget http://nodejs.org/dist/v0.10.28/node-v0.10.28-linux-x64.tar.gz && \
- tar -xzf node-v0.10.28-linux-x64.tar.gz && \
- mv node-v0.10.28-linux-x64 node && \
- cd /usr/local/bin && \
- ln -s /opt/node/bin/* . && \
- rm -f /opt/node-v0.10.28-linux-x64.tar.gz
這會下載并提取64位的NodeJS二進(jìn)制文件.
- WORKDIR /src
這句會告訴docker一旦容器已經(jīng)啟動，在執(zhí)行ＣＭＤ屬性指定的東西之前，要做一次 cd /src.
- CMD ["/bin/bash"]
作為***一步，運(yùn)行 /bin/bash.
構(gòu)建并運(yùn)行容器
現(xiàn)在ｄｏｃｋｅｒ文件寫好了，讓我們來構(gòu)建一個Ｄｏｃｋｅｒ鏡像吧.
- docker build -t sqldump/docker-dev:0.1 .
一旦把鏡像構(gòu)建好了，我們就可以使用下面的語句運(yùn)行一個容器了:
- docker run -i -t --rm \
- -p 3000:3000 \
- -v `pwd`:/src \
- sqldump/docker-dev:0.1
讓我們來看一看docker運(yùn)行命令中發(fā)生了什么.
-i 會在交互模式下啟動容器(對比 -d 是在分離模式下). 這就意味一旦交互會話結(jié)束，容器就會退出.
-t 會分配一個pseudo-tty.
--rm 會在退出時移除容器及其文件系統(tǒng).
-p 3000:3000 會將主機(jī)上的端口 3000 轉(zhuǎn)發(fā)到容器上的端口3000.
- -v `pwd`:/src
這句將會將當(dāng)前的工作目錄掛載到主機(jī)上(例如，我們的項(xiàng)目文件)容器中的 /src 里面. 我們將當(dāng)前目錄作為一個卷掛在，而不是使用Dockerfile中的ADD命令，那樣我們在文本編輯器中做的任何修改都可以立即在容器中看到了.
sqldump/docker-dev:0.1 是要運(yùn)行的docker鏡像的名稱和版本 – 這跟我們用來構(gòu)建docker鏡像時使用的名稱和版本是相同的.
由于Dockerfile指定了CMD ["/bin/bash"], 容器一啟動，我們就會登錄到一個bash shell環(huán)境中. 如果docker運(yùn)行命令執(zhí)行成功了，就會像下面這樣:
#p#
開始開發(fā)
現(xiàn)在容器是運(yùn)行起來了，在開始寫代碼之前，我們將需要整理出一些標(biāo)準(zhǔn)的，非docker相關(guān)的東西. 首先，要使用下面的語句啟動容器里面的redis服務(wù)器:
- service redis-server start
然后，要安裝項(xiàng)目依賴和nodemon. Nodemon 會觀察項(xiàng)目文件中的變更，并適時重啟服務(wù)器.
- npm install
- npm install -g nodemon
***，使用如下命令啟動服務(wù)器:
- nodemon server.js
現(xiàn)在，如果你在瀏覽器中導(dǎo)航到 http://localhost:3000, 你應(yīng)該會看到像下面這樣的東西:
讓我們來像Server.js中加入另外一個端點(diǎn)，以模擬開發(fā)流程:
- app.get('/hello/:name', function(req, res) {
- res.json({
- hello: req.params.name
- });
- });
你會看到nodemon已經(jīng)偵測到了你所做的修改，并重啟了服務(wù)器:
而現(xiàn)在，如果你將瀏覽器導(dǎo)航到http://localhost:3000/hello/world, 你會看到如下的響應(yīng):
生產(chǎn)環(huán)境
當(dāng)前狀態(tài)下的容器，還遠(yuǎn)不能作為產(chǎn)品發(fā)布.redis中的數(shù)據(jù)不會再跨容器重啟時仍然保持持久化, 比方說，如果你重啟了容器，所有的會話數(shù)據(jù)就都灰飛煙滅了. 同樣的事情在你銷毀容器并開啟一個的新的容器時也會發(fā)生，明顯這不是你想要的。我將會在第二部分的產(chǎn)品化內(nèi)容中講到這個問題.
英文原文：Develop a NodeJS App With Docker
譯文鏈接：http://www.oschina.net/translate/develop-a-nodejs-app-with-docker
