摘要：而項(xiàng)目代碼會(huì)隨著需求變更而經(jīng)常變化。項(xiàng)目啟動(dòng)后一般會(huì)有兩個(gè)目錄會(huì)寫入文件。

其實(shí)這個(gè)話題很簡單，不是很想寫這篇文章。不過的確還是有很多朋友在打包構(gòu)建部署上存在一些問題，恰巧最近使用 Docker 部署了幾個(gè) ThinkJS 相關(guān)的項(xiàng)目，所以還是拿出來說說吧。需要提前說明的是本文并不是 Docker 的基礎(chǔ)教程，默認(rèn)大家都是了解 Docker 的。然后我會(huì)分享一下我覺得 ThinkJS 項(xiàng)目構(gòu)建和部署過程中可能需要注意的點(diǎn)，我們先說說如何構(gòu)建鏡像，然后再說一下可能出現(xiàn)的問題。

FROM mhart/alpine-node:8.9.4

首先推薦大家基于 mhart/alpine-node 的鏡像來構(gòu)建，因?yàn)檎娴暮苄。?0M左右）！不過因?yàn)樾∮泻芏嗟臉?gòu)建工具都不是很全，如果遇上一些安裝時(shí)需要編譯的模塊時(shí)可能會(huì)缺少環(huán)境，這個(gè)時(shí)候你可以選擇手動(dòng)去安裝環(huán)境，當(dāng)然也可以選擇使用 Docker 官方的 library/node 鏡像（800M左右），為了省事推薦這種情況下還是使用后者比較好。

COPY package.json /animaris/package.json
RUN npm i --production --registry=https://registry.npm.taobao.org

選好了基礎(chǔ)鏡像之后下面就需要拷貝項(xiàng)目文件了。這里推薦大家先把 packge.json 文件 COPY 進(jìn)來然后安裝依賴。因?yàn)橐蕾嚨淖兓容^小，可以認(rèn)為一段時(shí)間內(nèi)這部分的鏡像層都是穩(wěn)定的。而項(xiàng)目代碼會(huì)隨著需求變更而經(jīng)常變化。綜上所述，我們選擇讓不變的鏡像層優(yōu)先打包保證鏡像層的最大可復(fù)用性。

一個(gè)正常的 ThinkJS 項(xiàng)目其實(shí)線上運(yùn)行只需要以下幾個(gè)文件：

app/：項(xiàng)目原始碼文件夾，如果是未編譯項(xiàng)目的話對(duì)應(yīng)的是 src/ 目錄

view/：前端模板文件夾

www/：前端靜態(tài)資源文件夾

production.js：ThinkJS 啟動(dòng)腳本

所以只要按照順序把這些文件 COPY 進(jìn)去就可以了。

大家平常都習(xí)慣使用 PM2 來啟動(dòng) NodeJS 項(xiàng)目，它最大的好處就是能夠幫我們守護(hù)項(xiàng)目進(jìn)程，當(dāng)進(jìn)程被殺死的時(shí)候能幫我們自動(dòng)重啟。不過 Docker 本身就是有自動(dòng)重啟的特性的，所以在很多層面上 Docker 和 PM2 一塊使用都有點(diǎn)沖突。其實(shí)因?yàn)?Docker 充當(dāng)了守護(hù)的角色，我們完全可以直接使用 node production.js 命令去啟動(dòng)。以下是一個(gè)完整的 ThinkJS 項(xiàng)目 Dockerfile 示例：

FROM mhart/alpine-node:8.9.4

WORKDIR /animaris
COPY package.json /animaris/package.json
RUN npm i --production --registry=https://registry.npm.taobao.org

COPY src /animaris/src
COPY view /animaris/view
COPY www /animaris/www
COPY production.js /animaris/production.js

ENV DOCKER=true
EXPOSE 8360
CMD [ "node", "/animaris/production.js" ]

使用如下命令進(jìn)行構(gòu)建：

docker build -t lizheming/animaris ./Dockerfile

之后使用如下命令運(yùn)行鏡像，即可使用 http://localhost:8360 訪問網(wǎng)站：

docker run -p 8360:8360 lizheming/animaris

使用 Docker 一定不能忘記的特性就是容器銷毀后容器內(nèi)的所有資源都是會(huì)被銷毀的，下回會(huì)重新初始化，所以如果是需要持久化保存的應(yīng)避免寫到容器中，需要選擇外部的持久化存儲(chǔ)，例如 Volume 共享卷或者 S3 等相關(guān)服務(wù)。

ThinkJS 項(xiàng)目啟動(dòng)后一般會(huì)有 logs, runtime 兩個(gè)目錄會(huì)寫入文件。其中 logs 是用來存儲(chǔ)線上日志用的，這個(gè)最好使用共享卷的形式外載出來，方便之后排查問題。runtime 這個(gè)是 ThinkJS 運(yùn)行時(shí)臨時(shí)文件的存儲(chǔ)地方，例如 cache 和 session 等。session 會(huì)話默認(rèn)是使用文件類型存儲(chǔ)的，如果使用 Docker 的話推薦選擇 MySQL 等外部存儲(chǔ)。其它的功能有相關(guān)需求也可以參考 session 服務(wù)。當(dāng)然如果懶得用直接把 runtime 共享卷出來也是可以的。

還有就是如果有用戶上傳類的需求會(huì)上傳到本地文件夾上也要記得共享出來，否則丟數(shù)據(jù)就完蛋叻！

ThinkJS 一直主張?jiān)谏a(chǎn)環(huán)境中使用 Nginx 來處理靜態(tài)資源，這樣不需要經(jīng)過 Node 層直接 Server 轉(zhuǎn)發(fā)性能會(huì)更高。不過這樣就給鏡像打包造成了一定的麻煩，因?yàn)殪o態(tài)資源也被打包到項(xiàng)目鏡像里去了，而 Nginx 鏡像正常是沒辦法跨鏡像讀取到文件的，所以就死解了。

在 ThinkJS 中是利用 think-resource 這個(gè)中間件來處理靜態(tài)資源的訪問的，然后它在線上環(huán)境的狀態(tài)是 enabled: false。其實(shí)靜態(tài)資源過一層 Node 并消耗不了多少資源，除非對(duì)性能有嚴(yán)苛要求的，我建議都可以直接把這個(gè)功能打開。這樣所有的請(qǐng)求都統(tǒng)一成 Nginx 轉(zhuǎn)發(fā)到 Node 鏡像，解決了 Nginx 需要跨鏡像讀取文件的問題。具體可參考官方文檔的“為什么上線后靜態(tài)資源訪問不了？”

module.exports = [
  ...
  {
    handle: "resource",
    enable: true // 始終開啟，默認(rèn)為 `enable: isDev` 表示只再開發(fā)環(huán)境下開啟
  },
  ...
]

當(dāng)然如果真的要在打包成一個(gè)鏡像的情況下用 Nginx 處理靜態(tài)資源也不是沒有辦法，我們可以利用共享卷來操作。Node 鏡像通過將鏡像文件共享卷的形式映射到本地，然后 Nginx 鏡像通過共享卷的形式將之前本地映射的文件再映射到鏡像中。這樣通過本地的一層轉(zhuǎn)發(fā)即可實(shí)現(xiàn) Nginx 的跨鏡像訪問靜態(tài)資源。

# ThinkJS 鏡像
docker run 
    -v ./www:/app/www 
    -p 8360:8360 
lizheming/animaris

# Nginx 鏡像
docker run 
    -v ./nginx.conf:/etc/nginx/conf.d/animaris.conf 
    -v ./www:/var/www/animaris/www 
    -p 80:80 
nginx

server {
    listen 80;
    server_name animaris.eming.li;
    root /var/www/animaris/www;

    location ~ /static/ {
        etag         on;
        expires      max;
    }
}

平常我們是使用 development.js 和 production.js 來區(qū)分開發(fā)環(huán)境和生產(chǎn)環(huán)境的，然鵝這么打包之后發(fā)現(xiàn)都是生產(chǎn)環(huán)境了。這樣有時(shí)候我們需要不同環(huán)境不同配置就不太好弄了。這里推薦大家使用環(huán)境變量來區(qū)分。

think.env = process.ENV.ENV;

docker run -e ENV=test -p 8360:8360 lizheming/animaris

有用戶提出疑問 #1106，說“網(wǎng)站500了為啥 logs 里沒看到日志？”。這是因?yàn)殡m然 ThinkJS 內(nèi)部的日志都是用 think-logger 模塊處理了，但是因?yàn)榭缒K或者啟動(dòng)時(shí)機(jī)的問題，有一些日志沒辦法走日志模塊記錄并存儲(chǔ)到文件，會(huì)直接打到終端里。所以當(dāng)沒有日志的時(shí)候我們可以考慮去 docker logs 中撈一下終端的日志，說不定有意外的驚喜。

雖然文字寫了很多，除了一些普適問題需要考慮一下之外，其實(shí)整體來看真?zhèn)€構(gòu)建過程還是很簡單的。同時(shí)也歡迎大家有什么問題和疑問留言交流。