摘要：部署項目寫在前面作為輕量級虛擬化技術(shù)，擁有持續(xù)集成版本控制可移植性隔離性和安全性等優(yōu)勢。容器可以被創(chuàng)建啟動停止刪除暫停等。重新運(yùn)行應(yīng)用容器直接基于鏡像來啟動容器，運(yùn)行命令將宿主機(jī)的掛載到容器的目錄上。

Docker 部署 vue 項目 1.寫在前面：

Docker 作為輕量級虛擬化技術(shù)，擁有持續(xù)集成、版本控制、可移植性、隔離性和安全性等優(yōu)勢。本文使用Docker來部署一個vue的前端應(yīng)用，并盡可能詳盡的介紹了實現(xiàn)思路和具體步驟，以方便有類似需要的同學(xué)參考。

Docker 是一個開源的應(yīng)用容器引擎，讓開發(fā)者可以打包他們的應(yīng)用以及依賴包到一個可移植的容器中，該容器包含了應(yīng)用程序的代碼、運(yùn)行環(huán)境、依賴庫、配置文件等必需的資源，通過容器就可以實現(xiàn)方便快速并且與平臺解耦的自動化部署方式，無論你部署時的環(huán)境如何，容器中的應(yīng)用程序都會運(yùn)行在同一種環(huán)境下。（更多詳情請移步docker官網(wǎng)查看docker）

默認(rèn)已經(jīng)安裝了 docker，@vue/cli

相關(guān)版本：

Docker version 18.09.2, build 6247962

vue cli --version 3.3.0

macOS Mojave Verison 10.14.1

運(yùn)行環(huán)境為macOS，如果與閱讀者操作系統(tǒng)之間存在差異，請自行調(diào)整

相關(guān)鏡像：

nginx:latest

node:latest

2.具體實現(xiàn)：

用 vue cli 創(chuàng)建一個vue項目，修改一下創(chuàng)建出來的項目，在頁面上寫一個前端接口請求，構(gòu)建一版線上資源 ，基于nginx docker鏡像構(gòu)建成一個前端工程鏡像，然后基于這個前端工程鏡像，啟動一個容器 vuenginxcontainer。
啟動一個基于 node 鏡像的容器 nodewebserver，提供后端接口。
修改 vuenginxcontainer 的 nginx 配置，使前端頁面的接口請求轉(zhuǎn)發(fā)到 nodewebserver 上。
稍作優(yōu)化和改進(jìn)。

3 創(chuàng)建 vue 應(yīng)用

3.1 vue cli 創(chuàng)建一個vue項目

運(yùn)行命令

yarn serve / npm run serve

訪問 http://localhost:8081

3.2 改寫

稍微改寫一下頁面，在App.vue中 傳入HelloWorld 組件中的 msg 改為Hello Docker ; created 生命周期中加入一個接口請求

import axios from "axios";

……

axios.get("/api/json", {
  params: {}
}).then(
  res => {
    console.log(res);
  }
).catch(
  error => {
      console.log(error);
  }
)

……

這時候會在頁面控制臺看到一個報錯信息:

/api/json 接口 404，當(dāng)然此時這個接口還不存在，暫時寫到這里，一會再調(diào)這個接口。

3.3 構(gòu)建vue項目

運(yùn)行命令

yarn build / npm run build

此時工程根目錄下多出一個dist文件夾

如果將該dist目錄整個傳到服務(wù)器上，部署成靜態(tài)資源站點(diǎn)就能直接訪問到該項目。

接下來就來構(gòu)建一個這樣的靜態(tài)資源站點(diǎn)。

4 構(gòu)建vue應(yīng)用鏡像

nginx 是一個高性能的HTTP和反向代理服務(wù)器，此處我們選用 nginx 鏡像作為基礎(chǔ)來構(gòu)建我們的vue應(yīng)用鏡像。

4.1 獲取 nginx 鏡像

docker pull nginx

docker鏡像（Image）一個特殊的文件系統(tǒng)。Docker鏡像是一個特殊的文件系統(tǒng)，除了提供容器運(yùn)行時所需的程序、庫、資源、配置等文件外，還包含了一些為運(yùn)行時準(zhǔn)備的一些配置參數(shù)（如匿名卷、環(huán)境變量、用戶等）。 鏡像不包含任何動態(tài)數(shù)據(jù)，其內(nèi)容在構(gòu)建之后也不會被改變。
docker 鏡像相關(guān)操作有: 搜索鏡像docker search [REPOSITORY[:TAG]]、拉取鏡像docker pull [REPOSITORY[:TAG]] 、查看鏡像列表docker image ls、刪除鏡像：docker image rm [REPOSITORY[:TAG]] / docker rmi [REPOSITORY[:TAG]] 等等。
docker 鏡像名稱由REPOSITORY和TAG組成 [REPOSITORY[:TAG]]，TAG默認(rèn)為latest

4.2 創(chuàng)建 nginx config配置文件

在項目根目錄下創(chuàng)建nginx文件夾，該文件夾下新建文件default.conf

server {
    listen       80;
    server_name  localhost;

    #charset koi8-r;
    access_log  /var/log/nginx/host.access.log  main;
    error_log  /var/log/nginx/error.log  error;

    location / {
        root   /usr/share/nginx/html;
        index  index.html index.htm;
    }

    #error_page  404              /404.html;

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

該配置文件定義了首頁的指向為 /usr/share/nginx/html/index.html, 所以我們可以一會把構(gòu)建出來的index.html文件和相關(guān)的靜態(tài)資源放到/usr/share/nginx/html目錄下。

4.3 創(chuàng)建 Dockerfile 文件

FROM nginx
COPY dist/ /usr/share/nginx/html/
COPY nginx/default.conf /etc/nginx/conf.d/default.conf

自定義構(gòu)建鏡像的時候基于Dockerfile來構(gòu)建。
FROM nginx 命令的意思該鏡像是基于 nginx:latest 鏡像而構(gòu)建的。
COPY dist/ /usr/share/nginx/html/ 命令的意思是將項目根目錄下dist文件夾下的所有文件復(fù)制到鏡像中 /usr/share/nginx/html/ 目錄下。
COPY nginx/default.conf /etc/nginx/conf.d/default.conf 命令的意思是將nginx目錄下的default.conf 復(fù)制到 etc/nginx/conf.d/default.conf，用本地的 default.conf 配置來替換nginx鏡像里的默認(rèn)配置。

4.4 基于該Dockerfile構(gòu)建vue應(yīng)用鏡像

運(yùn)行命令（注意不要少了最后的 “.” ）

docker build -t vuenginxcontainer .

-t 是給鏡像命名 . 是基于當(dāng)前目錄的Dockerfile來構(gòu)建鏡像

查看本地鏡像，運(yùn)行命令

docker image ls | grep vuenginxcontainer

到此時我們的 vue 應(yīng)用鏡像 vuenginxcontainer 已經(jīng)成功創(chuàng)建。接下來，我們基于該鏡像啟動一個docker容器。

4.5 啟動 vue app 容器

Docker 容器Container： 鏡像運(yùn)行時的實體。鏡像（Image）和容器（Container）的關(guān)系，就像是面向?qū)ο蟪绦蛟O(shè)計中的類和實例一樣，鏡像是靜態(tài)的定義，容器是鏡像運(yùn)行時的實體。容器可以被創(chuàng)建、啟動、停止、刪除、暫停等 。

基于 vuenginxcontainer 鏡像啟動容器，運(yùn)行命令：

docker run 
-p 3000:80 
-d --name vueApp 
vuenginxcontainer

docker run 基于鏡像啟動一個容器
-p 3000:80 端口映射，將宿主的3000端口映射到容器的80端口
-d 后臺方式運(yùn)行
--name 容器名
查看 docker 進(jìn)程

docker ps

可以發(fā)現(xiàn)名為 vueApp的容器已經(jīng)運(yùn)行起來。此時訪問 http://localhost:3000 應(yīng)該就能訪問到該vue應(yīng)用:

目前為止，已經(jīng)通過docker容器部署了一個靜態(tài)資源服務(wù)，可以訪問到靜態(tài)資源文件。還有 /api/json這個接口數(shù)據(jù)沒有，接下來我們來解決一下這個問題。

5 接口服務(wù)

再部署一個 node 的容器來提供接口服務(wù)

5.1 express 服務(wù)

用 node web 框架 express 來寫一個服務(wù)，注冊一個返回json數(shù)據(jù)格式的路由 server.js:

"use strict";

const express = require("express");

const PORT = 8080;
const HOST = "0.0.0.0";

const app = express();
app.get("/", (req, res) => {
    res.send("Hello world
");
});

app.get("/json", (req, res) => {
    res.json({
        code: 0,
        data :"This is message from node container"
    })
});

app.listen(PORT, HOST);
console.log(`Running on http://${HOST}:${PORT}`);

運(yùn)行該 express 應(yīng)用需要 node 環(huán)境，我們基于 node 鏡像來構(gòu)建一個新鏡像

5.2 獲取 node 鏡像

docker pull node

5.3 編寫 Dockerfile 將 express 應(yīng)用 docker 化

FROM node

WORKDIR /usr/src/app

COPY package*.json ./

RUN npm install

COPY . .

EXPOSE 8080
CMD [ "npm", "start" ]

構(gòu)建鏡像的時候 node_modules 的依賴直接通過 RUN npm install 來安裝，項目中創(chuàng)建一個 .dockerignore文件來忽略一些直接跳過的文件：

node_modules
npm-debug.log

5.4 構(gòu)建 nodewebserver 鏡像

運(yùn)行構(gòu)建命令：

  docker build -t nodewebserver .

5.5 啟動 nodeserver 容器

基于剛剛構(gòu)建的 nodewebserver 鏡像 啟動一個名為 nodeserver 的容器來提供接口服務(wù)8080端口，并映射宿主的5000端口

docker run 
-p 5000:8080 
-d --name nodeserver 
nodewebserver

查看當(dāng)前docker進(jìn)程

docker ps

可以發(fā)現(xiàn) nodeserver 的容器也正常的運(yùn)行起來。訪問以下 http://localhost:5000/json 能訪問到前面寫的json數(shù)據(jù)

到目前為止，后端接口服務(wù)也正常啟動了。只需最后把頁面請求的接口轉(zhuǎn)發(fā)到后端接口服務(wù)就能調(diào)通接口。

6. 跨域轉(zhuǎn)發(fā)

想要將 vueApp 容器 上的請求轉(zhuǎn)發(fā)到 nodeserver 容器上。首先需要知道 nodeserver 容器的ip地址和端口，目前已知 nodeserver 容器內(nèi)部服務(wù)監(jiān)聽在 8080 端口，還需要知道ip即可。

6.1 查看 nodeserver 容器的 ip 地址：

查看容器內(nèi)部 ip 有多種方式，這里提供兩種：

進(jìn)入容器內(nèi)部查看

docker exect -it 02277acc3efc bash

cat /etc/hosts

docker inspect [ containerId ] 直接查看容器信息:

docker inspect 02277acc3efc

在其中找到 Networks 相關(guān)配置信息：

記錄下node服務(wù)容器對應(yīng)的ip，一會兒配置nginx轉(zhuǎn)發(fā)的時候會用到。

6.2 修改 nginx 配置

Nginx 配置 location 指向 node 服務(wù) default.conf （前端想要了解的Nginx，關(guān)于Nginx的配置已經(jīng) location 的具體寫法可以參考（一文弄懂Nginx的location匹配））

添加一條重寫規(guī)則，將 /api/{path} 轉(zhuǎn)到目標(biāo)服務(wù)的 /{path} 接口上。 在前面的nginx/default.conf文件中加入：

location /api/ {
  rewrite  /api/(.*)  /$1  break;
  proxy_pass http://172.17.0.2:8080;
}

修改完了之后意識到一個問題：vueApp 容器是基于 vuenginxcontainer 這個鏡像運(yùn)行的，而在一開始構(gòu)建鏡像的時候是將 nginx配置 default.conf 直接構(gòu)建進(jìn)去了。因此如果需要修改 default.conf 還得再重新構(gòu)建一個新的鏡像，再基于新鏡像來運(yùn)行新的容器。

7. 改進(jìn)

能不能每次修改配置文件后直接重啟容器就能讓新配置生效，答案當(dāng)然是有。

在構(gòu)建鏡像的時候 不把 Nginx 配置復(fù)制到鏡像中，而是直接掛載到宿主機(jī)上，每次修改配置后，直接重啟容器即可。

7.1 修改 Dockerfile 文件

把 vueclidemo 項目下的 Dockerfile 修改一下

FROM nginx
COPY dist/  /usr/share/nginx/html/
COPY nginx/default.conf /etc/nginx/conf.d/default.conf

將COPY nginx/default.conf /etc/nginx/conf.d/default.conf命令刪除，nginx配置都通過掛載命令掛載在宿主機(jī)上。再看 COPY dist/ /usr/share/nginx/html/ 命令，如果每次構(gòu)建的項目dist/下的內(nèi)容變動都需要重新走一遍構(gòu)建新鏡像再啟動新容器的操作，因此這條命令也可以刪除，使用掛載的方式來啟動容器。

7.2 重新運(yùn)行vue應(yīng)用容器

直接基于nginx鏡像來啟動容器 vuenginxnew ，運(yùn)行命令：

docker run 
-p 3000:80 
-d --name vuenginxnew 
--mount type=bind,source=$HOME/SelfWork/docker/vueclidemo/nginx,target=/etc/nginx/conf.d 
--mount type=bind,source=$HOME/SelfWork/docker/vueclidemo/dist,target=/usr/share/nginx/html 
nginx

--mount type=bind,source={sourceDir},target={targetDir} 將宿主機(jī)的sourceDir 掛載到容器的 targetDir 目錄上。
此處運(yùn)行的命令較長，如果每次重新輸入難免麻煩，我們可以將完整的命令保存到一個shell文件 vueapp.sh 中，然后直接執(zhí)行 sh vueapp.sh。

這樣就能每次修改了nginx配置或者 重新構(gòu)建了vue應(yīng)用的時候，只需重啟容器就能立馬生效。 此時我們再訪問 http://localhost:3000/api/json 能看到接口能正常返回，說明轉(zhuǎn)發(fā)生效了。

至此接口服務(wù)的轉(zhuǎn)發(fā)也調(diào)通了。

7.3 配置負(fù)載均衡

后端服務(wù)一般都是雙機(jī)或者多機(jī)以確保服務(wù)的穩(wěn)定性。我們可以再啟動一個后端服務(wù)容器，并修改nginx的配置 來優(yōu)化資源利用率，最大化吞吐量，減少延遲，確保容錯配置。

基于前面 4.5 節(jié)的類似操作，新啟動一個容器，并基于 5.1 節(jié)類似的操作，查看到 新容器的 IP (172.17.0.3)

修改一下 nginx/default.conf（新增 upstream ，修改 location /api/ 中的 proxy_pass）:

  upstream backend {
      server 172.17.0.2:8080;
      server 172.17.0.3:8080;
  }

  ……

  location /api/ {
      rewrite  /api/(.*)  /$1  break;
      proxy_pass backend;
  }

8. 寫在后面

不習(xí)慣命令行的同學(xué)可以選用 Kitematic 來管理docker容器的狀態(tài)、數(shù)據(jù)目錄和網(wǎng)絡(luò)。所有對容量的操作都可以可視化的操作，這里就不做過多介紹了，有興趣的同學(xué)可以自行體驗下。

9 總結(jié)

docker提供了非常強(qiáng)大的自動化部署方式與靈活性，對多個應(yīng)用程序之間做到了解耦，提供了開發(fā)上的敏捷性、可控性以及可移植性。本文以vue項目為例實現(xiàn)一個前后分離項目使用docker部署的完整步驟，希望能給想要擁抱 docker 的同學(xué)帶來一點(diǎn)幫助。

10 Tail by hand

快狗打車前端團(tuán)隊專注前端技術(shù)分享，定期推送高質(zhì)量文章，歡迎關(guān)注點(diǎn)贊。

參考資源

docker 官網(wǎng)

nginx 官網(wǎng)

docker 從入門到實踐

Kitematic user guide

前端想要了解的Nginx

一文弄懂Nginx的location匹配