本文將示範如何以 Docker 為 Node.js 應用打造一個便於開發的容器環境,讓 Redis 與 Node 在同一個容器中運行。
關於這個 Node 應用
此應用包含 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 會拉取所有依賴並啟動應用。這個應用把會話資訊存到 Redis,並暴露一個端點,回應一個 JSON 狀態訊息。值得注意的是,Redis 的連線資訊可使用環境變數覆寫——這在稍後從開發環境遷移到正式環境時將派上用場。
Dockerfile
為了開發需要,我們讓 Redis 與 Node 在同一容器中運行,透過 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 https://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 作為建置的基準映像。
RUN apt-get -y -qq install python redis-server:基準映像幾乎不含任何東西,因此需用 apt-get 取得運行所需的一切。這行會安裝 python 與 redis-server——Redis 是必需的,因為會話資訊要存其中;python 則是為了讓 npm 能建置 Redis Node 模組所需的 C 擴充。
接著那段 RUN 指令會下載並解壓 64 位的 Node.js 執行檔,並建立符號連結。
WORKDIR /src:告訴 Docker 在容器啟動後、執行 CMD 之前先 cd /src。
CMD ["/bin/bash"]:作為最後一步,運行 /bin/bash。
建置並運行容器
Dockerfile 寫好後,即可建置映像:
docker build -t sqldump/docker-dev:0.1 .
映像建置完成後,用下面的語句運行容器:
docker run -i -t --rm \ -p 3000:3000 \ -v `pwd`:/src \ sqldump/docker-dev:0.1
來看這個 docker run 命令中發生了什麼:
-i 會在互動模式下啟動容器(對比 -d 是分離模式),意味著一旦互動工作階段結束,容器就會退出。
-t 會配置一個 pseudo-tty。
--rm 會在退出時移除容器及其檔案系統。
-p 3000:3000 會把主機上的埠口 3000 轉發到容器的埠口 3000。
-v `pwd`:/src 會把目前的工作目錄掛載到容器的 /src。以掛載卷的方式取代 Dockerfile 中的 ADD 命令,這樣我們在文字編輯器中做的任何修改都能立即在容器中看到。
sqldump/docker-dev:0.1 則是要運行的映像名稱與版本。
由於 Dockerfile 指定了 CMD ["/bin/bash"],容器一啟動便會進入 bash shell。若運行成功,就會看到如下畫面:

開始開發
容器運行起來後,在寫程式碼前,我們需要先做一些標準的、與 Docker 無關的準備。首先啟動容器內的 Redis 伺服器:
service redis-server start
接著安裝專案依賴與 nodemon。nodemon 會監看檔案變更並適時重啟伺服器:
npm install npm install -g nodemon
最後啟動伺服器:
nodemon server.js
現在,若在瀏覽器中導航到 https://localhost:3000,應該會看到如下畫面:

讓我們在 server.js 中加入另一個端點,以模擬開發流程:
app.get('/hello/:name', function(req, res) {
res.json({ hello: req.params.name });
});
你會看到 nodemon 偵測到修改並重啟了伺服器:

此時若把瀏覽器導航到 https://localhost:3000/hello/world,你會看到如下回應:

正式環境
目前狀態的容器還遠不能作為正式產品發布。比方說,Redis 中的資料不會在容器重啟後仍保持持久化——一旦重啟容器,所有會話資料便付之一炬;銷毀容器再開啟新容器時也是同樣情況,這顯然不是我們想要的。這個問題將在後續的產品化內容中進一步探討。