標籤：

Angular 容器部署

04-23

很多人反應很難訪問 Github Page，所以 ng-alain.com 轉移到阿里雲伺服器上，因此做了一次完整的 Angular 容器部署。

以下我會闡述 ng-alain 整個過程，其中包括 Docker、Nginx、Lets Sencrypt 證書等范濤，我無法保證新手可以很好的閱讀她，不過你可以通過一些文章關鍵字在搜索引擎獲得更多資料。

我們知道Docker有兩個很重要的概念：鏡像、容器。而Anguar容器部署只需要把Angular構建的生產環境（例如：ng build -prod）產生的目錄 dist 寫入至一個靜態伺服器鏡像（例如：Nginx），最後實例這個鏡像。

一、構建Angular鏡像

1、編譯Angular

一般而言會把 Angular 構建也在一個容器內完成，在 Angular 項目根目錄下創建 Dockerfile.compile 文件：

FROM node:8LABEL authors="cipchk <cipchk@qq.com>"WORKDIR /usr/src/appCOPY package.json package.jsonRUN npm config set registry https://registry.npm.taobao.org && npm iCOPY . .RUN ng build --prod

  • FROM 指定一個 node 基礎鏡像，這是構建 Angular 項目的最簡的基本
  • LABEL 鏡像元數據，例如 authors 作者信息
  • WORKDIR 指定鏡像內工作目錄
  • COPY 複製項目 package.json 並安裝依賴包
  • RUN 複製項目文件後並執行 ng build 命令

最後，執行構建鏡像命令：

docker build -f Dockerfile.build -t ng-app-build .

其中 ng-app-build 表示鏡像名稱。

2、Angular 運行環境

我們並不會基於編譯 Angular 鏡像基礎上構建 Angualr 運行環境鏡像，因此裡頭包括很多無意義的文件，例如 npm i 產生的 node_modules。而是從上述鏡像提取 dist 目錄，併產生一個新鏡像；Angular 運行環境應該是一個乾淨、簡單的。

因此，從編譯 Angular 鏡像提取 dist：

# 運行編譯 Angular 鏡像docker run --name ng-app-build ng-app-build# 將 `dist` 複製到項目根目錄下docker cp ng-app-build:/usr/src/app/dist ./dist/# 刪除編譯 Angular 鏡像實例docker rm -f ng-app-build

注意： 容器路徑必須上一步 Angular 編譯的 WORKDIR 路徑

最後，在 Angular 項目根目錄下創建 Dockerfile.package 文件：

FROM nginxCOPY _nginx/default.conf /etc/nginx/conf.d/RUN rm -rf /usr/share/nginx/html/*COPY /dist /usr/share/nginx/htmlCMD ["nginx", "-g", "daemon off;"]

參數和上一節略同，只是將提取的 dist 寫入到鏡像內的 Nginx 默認運行目錄里。

同時把 Angular 項目的 _nginx/default.conf 作為 Nginx 的配置文件，在項目里包括 Nginx 配置，像使用HTML5路由策略時需要處理 404 問題、GZip等。

但是我比較建設這裡的 Nginx 配置應該極簡單化，把一些 GZip、SSL 統一在反向代理層上完成，畢竟容器化後的應用不可能在一台機器上只部署一個應用。

以下是一個 Angular 應用最簡化的配置信息：

server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; index index.html index.htm; try_files $uri $uri/ /index.html; } error_page 500 502 503 504 /50x.html; location = /50x.html { root /usr/share/nginx/html; }}

try_files 可以保證當訪問的路徑未找到文件時直接使用 index.html 文件替代，這也就是 Angular HTML5 路由策略很重要的一環。

最後，構建生產環境鏡像：

docker build -f Dockerfile -t ng-app .

當然，這個時候的編譯 Angular 鏡像已經沒有存在的意義了。

docker rmi -f ng-app-build

二、運行Angular

我們可以查看已經存在的鏡像：

docker images

當然，上述在 Nginx 配置採用的是一個 80 埠，因此可以直接使用：

docker run -d -p 80:80 --name web ng-app

若你域名綁定了該主機，則可以直接訪問。至此，已經是 Angular 容器化後所有內容，下面是關於 Nginx 反向代理 Docker 應用的部分，若你已經這麼做，那直接忽略下一章節。

Nginx 反向代理

絕大多數情況下會利用一個代理伺服器容器，來轉發多個站點，因此很少會直接在一個 Angular 站點裡直接使用 80 埠，而是透過另一個代理層進行轉發。

在之前我嘗試使用 jwilder/nginx-proxy 鏡像來處理，它真的非常方便，但是在SSL環節讓我吃了很多苦頭，最後放棄之，而改用直接在主機上安裝 Nginx 作為反向代理。

在Angular容器化過程中，我們並未配置任何 SSL、GZip 等，只是保留 Nginx 服務所需的配置項而已，而這一部分我們可以放在反向代理層完成。

這個過程包括三個步驟：安裝 Nginx、安裝 acme.sh 簽發 Lets Sencrypt 證書、配置並運行 Nginx。

1、安裝Nginx

以 CenOS7 為例，更多系統請自行Google：

sudo yum install epel-releasesudo yum install nginx# 啟動Nginxsudo systemctl start nginx

2、通過acme.sh簽發證書

acme.sh 是國內一大牛寫的用於簡化申請 Lets Sencrypt 證書，並自動續簽證書，幾乎上第一次安裝完全後，後續都無須人工干預。

Lets Sencrypt 不久前發布支持泛域，因此這一次也是申請了 *.ng-alain.com 泛域證書。

安裝 acem.sh：

curl https://get.acme.sh | sh

這裡我使用DNS來簽發證書，目前支持幾十種服務商，當然包括阿里云：

export Ali_Key="aaaaaaaaaaa"export Ali_Secret="xxxxxxxxxxxxxxxx"acme.sh --issue --dns dns_ali -d ng-alain.com -d *.ng-alain.com

Ali_Key 和 Ali_Secret 是對應的阿里雲的 Access key，注意要給予 DNS 授權。

最後，利用 --installcert 來提取 Nginx 所需要的證書文件。

acme.sh --installcert -d ng-alain.com --key-file $(pwd)/proxy/certs/ng-alain.com.key --fullchain-file $(pwd)/proxy/certs/fullchain.cer --reloadcmd "service nginx force-reload"

acme.sh 會紀錄這行命令的所有細節，並且當自動續簽觸發後再一次執行它們。其中 service nginx force-reload 是指命令執行完成後重啟 nginx 使啟證書立刻生效。

整個過程我非常順利，沒有任何錯誤，acme.sh 也有很多說明文檔，包括中文，有關更多細節請自行閱讀。

3、運行 Nginx

之前在安裝 Nginx 時我們就已經啟動了，那麼，我們只需要對 /etc/nginx/nginx.conf 編寫一些 Nginx 配置即可。

有兩個主要細節：SSL配置和代理轉化Angular容器實例埠的配置。

對於前者，若你在運行上述命令時依然保持路徑的話，則：

ssl_certificate /root/proxy/certs/fullchain.cer;ssl_certificate_key /root/proxy/certs/ng-alain.com.key;ssl_session_timeout 30m;ssl_protocols TLSv1 TLSv1.1 TLSv1.2;ssl_ciphers ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:ECDH+3DES:DH+3DES:RSA+AESGCM:RSA+AES:RSA+3DES:!aNULL:!MD5:!DSS;ssl_session_cache shared:SSL:10m;ssl_prefer_server_ciphers on;

而對於代理轉化，這其決於你映射Angular容器的埠，例如上述在運行容器的命令是這樣：

docker run -d -p 80:80 --name web ng-app

我們可以重新換另一個映射埠，例如：8001。

docker kill webdocker run -d -p 8001:80 --name web ng-app

然後在 Nginx 配置相應的代理轉化：

server { listen 80; server_name ng-alain.com www.ng-alain.com; return 301 https://$server_name$request_uri;}server { listen 443 ssl http2; server_name ng-alain.com www.ng-alain.com; location / { proxy_pass http://127.0.0.1:8001/; }}

  • server 這裡有兩個分別對 80 和 443，前者強制跳轉 https，當你不希望用戶使用 http 訪問你站點時。
  • server_name 指定監聽的域名
  • proxy_pass 指定代理轉發域，8001 埠就是上述 Angular 應用所處容器所映射的埠

配置文件保持後，你可以先執行 nginx -t 來校驗配置文件是否正確。

最後，重啟 Nginx。

service nginx force-reload

三、持續部署

上述有系列的 Docker 命令甚是繁瑣，應該把這一切自動化，有個專業名稱叫：持續部署（簡稱：cd）；ng-alain.com 現在是使用 DaoCloud 完成這項工作。

DaoCloud 提供一種叫【安全鏡像】的構建功能，分為三個步驟——編譯、提取、打包；等同上述 Angular 項目的編譯、提供和發布。

只需要在項目下創建 daocloud.yml；它是 DaoCloud 提供的一種自定義項目流程的定義文件，若你對上述已經了解，再來看它就不會非常陌生。以下是 ng-alain.com 完整的 daocloud.yml 內容：

version: 3stages:- compile- deployrelease: stage: compile job_type: lite_image_build only: branches: - master allow_failure: false compile: build_dir: / cache: false dockerfile_path: /Dockerfile.compile extract: - /usr/src/app/dist - /usr/src/app/_nginx/default.conf package: build_dir: / cache: false dockerfile_path: /Dockerfile.packageself: stage: deploy job_type: DCS_deploy only: branches: - master allow_failure: false dependencies: - release app_name: web cluster_id: ""

注意： 其中 extract 務必包含完整路徑。

四、總結

將生產環境容器化已經是一種架構標準，上述只是在部署 ng-alain.com 的一些總結，實際可能遇到的問題會更多，大家可以通過以下找到答案：

  • Docker — 從入門到實踐
  • Docker 問答錄（100 問）
  • DaoCloud Services 文檔

當然，未來Angular cli 也將會內置 Docker 部署，這裡有一份來自 Angular 的相關 ng docker 命令的設計文檔。

以上所有代碼可以在 delon 上找得到，可能存在個人路徑不同罷了。

（完）


推薦閱讀：

TAG:Angular | Docker | LetsEncrypt |