基于 Docker 開(kāi)發(fā) NodeJS 應(yīng)用
這是兩篇文章的***篇。本文涵蓋了有關(guān)在使用Express框架開(kāi)發(fā)一個(gè)Node應(yīng)用時(shí)，用Docker 替代Vagrant 的比較詳細(xì)的教程, 應(yīng)用將使用 connect-redis 中間件將會(huì)話信息持久化到Redis中. 第二篇文章將介紹到將這個(gè)開(kāi)發(fā)的設(shè)置產(chǎn)品化.
有關(guān)這個(gè) Node 應(yīng)用
此應(yīng)用包含一個(gè) package.json, server.js 以及一個(gè) .gitignore 文件, 它們簡(jiǎn)單到可以信手拈來(lái).
.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 會(huì)拉取所有的依賴并啟動(dòng)一個(gè)特定的應(yīng)用. 這個(gè)特定的應(yīng)用被設(shè)定成將會(huì)話信息存儲(chǔ)到Redis中，并暴露出一個(gè)請(qǐng)求端點(diǎn)，其會(huì)響應(yīng)返回一個(gè)JSON的狀態(tài)消息. 這都是非常標(biāo)準(zhǔn)的東西.
需要注意的一件事情就是針對(duì)Redis的連接信息可以使用環(huán)境變量重寫(xiě)——這將會(huì)在稍后從開(kāi)發(fā)環(huán)境dev遷移到生產(chǎn)環(huán)境prod時(shí)起到作用.
Dockerfile
為了開(kāi)發(fā)的需要，我們將會(huì)讓Redis和Node在同一個(gè)容器中運(yùn)行。為此，我們將使用一個(gè)Dockerfile來(lái)配置這個(gè)容器。
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"]
我們一行一行的來(lái)理解,
- FROM dockerfile/ubuntu
這回告訴docker要使用Docker Inc. 提供的 dockerfile/ubuntu 鏡像. 作為構(gòu)建的基準(zhǔn)鏡像.
- RUN \
- apt-get -y -qq install python redis-server
基準(zhǔn)鏡像完全沒(méi)有包含任何東西——因此我們需要使用apt-get來(lái)獲取應(yīng)用運(yùn)行起來(lái)所需的所有東西. 這一句會(huì)安裝python 和 redis-server. Redis 服務(wù)器是必須的，因?yàn)槲覀儗?huì)把會(huì)話信息存儲(chǔ)到它之中，而python的必要性則是通過(guò)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
這會(huì)下載并提取64位的NodeJS二進(jìn)制文件.
- WORKDIR /src
這句會(huì)告訴docker一旦容器已經(jīng)啟動(dòng)，在執(zhí)行ＣＭＤ屬性指定的東西之前，要做一次 cd /src.
- CMD ["/bin/bash"]
作為***一步，運(yùn)行 /bin/bash.
構(gòu)建并運(yùn)行容器
現(xiàn)在ｄｏｃｋｅｒ文件寫(xiě)好了，讓我們來(lái)構(gòu)建一個(gè)Ｄｏｃｋｅｒ鏡像吧.
- docker build -t sqldump/docker-dev:0.1 .
一旦把鏡像構(gòu)建好了，我們就可以使用下面的語(yǔ)句運(yùn)行一個(gè)容器了:
- docker run -i -t --rm \
- -p 3000:3000 \
- -v `pwd`:/src \
- sqldump/docker-dev:0.1
讓我們來(lái)看一看docker運(yùn)行命令中發(fā)生了什么.
-i 會(huì)在交互模式下啟動(dòng)容器(對(duì)比 -d 是在分離模式下). 這就意味一旦交互會(huì)話結(jié)束，容器就會(huì)退出.
-t 會(huì)分配一個(gè)pseudo-tty.
--rm 會(huì)在退出時(shí)移除容器及其文件系統(tǒng).
-p 3000:3000 會(huì)將主機(jī)上的端口 3000 轉(zhuǎn)發(fā)到容器上的端口3000.
- -v `pwd`:/src
這句將會(huì)將當(dāng)前的工作目錄掛載到主機(jī)上(例如，我們的項(xiàng)目文件)容器中的 /src 里面. 我們將當(dāng)前目錄作為一個(gè)卷掛在，而不是使用Dockerfile中的ADD命令，那樣我們?cè)谖谋揪庉嬈髦凶龅娜魏涡薷亩伎梢粤⒓丛谌萜髦锌吹搅?
sqldump/docker-dev:0.1 是要運(yùn)行的docker鏡像的名稱和版本 – 這跟我們用來(lái)構(gòu)建docker鏡像時(shí)使用的名稱和版本是相同的.
由于Dockerfile指定了CMD ["/bin/bash"], 容器一啟動(dòng)，我們就會(huì)登錄到一個(gè)bash shell環(huán)境中. 如果docker運(yùn)行命令執(zhí)行成功了，就會(huì)像下面這樣:
#p#
開(kāi)始開(kāi)發(fā)
現(xiàn)在容器是運(yùn)行起來(lái)了，在開(kāi)始寫(xiě)代碼之前，我們將需要整理出一些標(biāo)準(zhǔn)的，非docker相關(guān)的東西. 首先，要使用下面的語(yǔ)句啟動(dòng)容器里面的redis服務(wù)器:
- service redis-server start
然后，要安裝項(xiàng)目依賴和nodemon. Nodemon 會(huì)觀察項(xiàng)目文件中的變更，并適時(shí)重啟服務(wù)器.
- npm install
- npm install -g nodemon
***，使用如下命令啟動(dòng)服務(wù)器:
- nodemon server.js
現(xiàn)在，如果你在瀏覽器中導(dǎo)航到 http://localhost:3000, 你應(yīng)該會(huì)看到像下面這樣的東西:
讓我們來(lái)像Server.js中加入另外一個(gè)端點(diǎn)，以模擬開(kāi)發(fā)流程:
- app.get('/hello/:name', function(req, res) {
- res.json({
- hello: req.params.name
- });
- });
你會(huì)看到nodemon已經(jīng)偵測(cè)到了你所做的修改，并重啟了服務(wù)器:
而現(xiàn)在，如果你將瀏覽器導(dǎo)航到http://localhost:3000/hello/world, 你會(huì)看到如下的響應(yīng):
生產(chǎn)環(huán)境
當(dāng)前狀態(tài)下的容器，還遠(yuǎn)不能作為產(chǎn)品發(fā)布.redis中的數(shù)據(jù)不會(huì)再跨容器重啟時(shí)仍然保持持久化, 比方說(shuō)，如果你重啟了容器，所有的會(huì)話數(shù)據(jù)就都灰飛煙滅了. 同樣的事情在你銷(xiāo)毀容器并開(kāi)啟一個(gè)的新的容器時(shí)也會(huì)發(fā)生，明顯這不是你想要的。我將會(huì)在第二部分的產(chǎn)品化內(nèi)容中講到這個(gè)問(wèn)題.
英文原文：Develop a NodeJS App With Docker
譯文鏈接：http://www.oschina.net/translate/develop-a-nodejs-app-with-docker
