很多人反應很難訪問 Github Page,所以 ng-alain.com 轉移到阿里云服務器上,因此做了一次完整的 Angular 容器部署。
以下我會闡述 ng-alain 整個過程,其中包括 Docker、Nginx、Let's 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
最后,執行構建鏡像命令:
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 簽發 Let's Sencrypt 證書、配置并運行 Nginx。
1、安裝Nginx
以 CenOS7 為例,更多系統請自行Google:
sudo yum install epel-releasesudo yum install nginx# 啟動Nginxsudo systemctl start nginx
2、通過acme.sh簽發證書
acme.sh 是國內一大牛寫的用于簡化申請 Let's Sencrypt 證書,并自動續簽證書,幾乎上第一次安裝完全后,后續都無須人工干預。
Let's 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/; }}
配置文件保持后,你可以先執行 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 上找得到,可能存在個人路徑不同罷了。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持武林網。
新聞熱點
疑難解答