將你的前端應用打包成docker鏡像並部署到服務器?僅需一個腳本搞定


1.前言

前段時間,自己搞了個阿里雲的服務器。想自己在上面折騰,但是不想因為自己瞎折騰而污染了現有的環境。畢竟,現在的阿里雲已經沒有免費的快照服務了。要想還原的話,最簡單的辦法就是重新裝系統。而一旦重裝,之前的搭建的所有環境就都白搭了。

再加上之前本身就想引入docker,所以就打算利用docker容器來部署這次的前端應用。

2.構建前端應用

在打包之前,首先需要一個可正常運行的前端應用。這個可以使用umi或者create-react-app來構建。

3.nginx的默認配置文件

然后需要在項目中加上默認nginx配置文件。

server {
    listen 80;
    server_name localhost;

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

4.編寫本地構建腳本

4.1. 移除上次的目錄和Dockerfile

#!/bin/bash

if [ -d "./dist" ]; then
    rm -rf ./dist
fi

if [ -f "./Dockerfile" ]; then
    rm -f ./Dockerfile
fi

因為每次更改后dist中的內容肯定與之前不同,其實這一步顯得不是那么必要。運行npm的打包命令也會自動清楚該目錄。

而清除Dockerfile則是為了防止更新了Dockerfile,而這次卻不能得到最新的配置。

4.2. 打包前端應用

執行前端的打包命令,生成靜態文件目錄。

yarn build

4.3. 生成Dockerfile

echo "FROM nginx:latest" >> ./Dockerfile
echo "COPY ./dist /usr/share/nginx/html/" >> ./Dockerfile
echo "COPY ./default.conf /etc/nginx/conf.d/" >> ./Dockerfile
echo "EXPOSE 80" >> ./Dockerfile

FROM制定了該定制容器的基礎鏡像為nginx:latest;COPY命里將打包好的靜態文件目錄復制到容器內的/usr/share/nginx/html/目錄下,然后將nginx的配置寫入容器中對應的位置; EXPOSE則是設置對外暴露容器的80端口。

4.4. 生成並推送定制image

docker build -t detectivehlh/mine .
docker login -u detectivehlh -p ********
docker push detectivehlh/mine

這里是在開發本地,使用docker命令來打包,所以該腳本對docker有強依賴。build命令表示打包docker應用的,-t選項則制定了docker鏡像的名字和tag,tag會默認為latest。

然后登錄dockerHub,將定制好的鏡像推送到dockerHub中。detectivehlh就是dockerHub的用戶名,mine是image的名字。

4.5. 刪除tag為none的無用image

第一次構建不會生成tag為none的image,但是后面每次再次執行該命令就會出現這樣的情況。所以每次構建了一個新的image后,需要清除調不需要的image。

docker images | grep none | awk '{print $3}' | xargs docker rmi

使用grep命令匹配到tag為none的image,awk是一個強大的文本分析工具,{print $3}表示打印出匹配到的每一行的第三個字段,也就是docker的image id。如果是$0的話表示當前整行的數據。

xargs是一個給其他命令(也就是后面的docker rmi)傳遞參數的一個過濾器,將標准輸入轉換成命令行參數。

總結來說,上述命令就是找到tag為none的image的ID,然后使用docker rmi命令移除該image。

4.6. 執行部署

cmd="cd ~ && sh deploy.sh mine"
ssh -t USER_NAME@IP_ADDRESS "bash -c \"${cmd}\""

通過ssh命令,登錄遠程服務器,並且執行參數中的腳本。

deploy.sh是放在服務端的構建腳本。放在默認的登錄用戶下。我們發現,后面還跟了個mine,這是在服務器上運行的docker鏡像的名字。這里暫時沒有對container的名字加上hash,因為自己的小項目,暫時沒有必要。

在項目中的完整構建腳本如下。

#!/bin/bash

if [ -d "./dist" ]; then
    rm -rf ./dist
fi
if [ -f "./Dockerfile" ]; then
    rm -f ./Dockerfile
fi

yarn build

echo "FROM nginx:latest" >> ./Dockerfile
echo "COPY ./dist /usr/share/nginx/html/" >> ./Dockerfile
echo "COPY ./default.conf /etc/nginx/conf.d/" >> ./Dockerfile
echo "EXPOSE 80" >> ./Dockerfile

docker build -t detectivehlh/mine .
docker login -u detectivehlh -p ********
docker push detectivehlh/mine

docker images | grep none | awk '{print $3}' | xargs docker rmi

cmd="cd ~ && sh deploy.sh mine"
ssh -t USER_NAME@IP_ADDRESS "bash -c \"${cmd}\""

5. 編寫服務器部署腳本

從上面步驟來看,我們還需要一個服務器端的部署腳本。大家可能會說,標題不是說一個腳本搞定嗎?em。。。服務器一個,本地一個...簡稱只需一個腳本。

5.1 接收參數

在本地的構建腳本中,我們傳入了docker運行的container的名字。在服務器構建腳本中需要來接收它。然后更新剛剛推送的docker image。

#!/bin/bash
name=$1
docker pull detectivehlh/$name

5.2. 啟動container

在啟動container時我們會面對兩種情況,名字為傳入參數的container已經在運行了。而在此時如果再次運行docker run命令就會報錯而導致我們無法使用最新的container,也無法達到更新應用的目的。

if docker ps | grep $name | awk {'print $(NF)'} | grep -Fx $name; then
	echo "Container mine is already start"
	docker stop $name
	docker rm $name
	docker run -d --name $name -p 3000:80 detectivehlh/$name
else
	echo "Container mine is not start!, starting"
	docker run -d --name $name -p 3000:80 detectivehlh/$name
	echo "Finish starting"
fi
docker images | grep none | awk '{print $3}' | xargs docker rmi

所以在這里做一個判斷,第一個if判斷如果存在名字為傳入參數的container正在運行,就停止當前容器再重新啟動。如果不存在則直接啟動容器。

run命令就不過多解釋了。-d表示后台運行容器並返回容器ID,--name表示設置容器的名字,-p表示設置端口,將阿里雲服務器的3000端口映射到容器的80端口,最后一句表示要啟動哪個image(好像還是解釋了一遍)。

最后一句就是移除多次更新后出現的tag為none的無用鏡像。完整的腳本如下。

#!/bin/bash
name=$1
docker pull detectivehlh/$name
if docker ps | grep $name | awk {'print $(NF)'} | grep -Fx $name; then
	echo "Container mine is already start"
	docker stop $name
	docker rm $name
	docker run -d --name $name -p 3000:80 detectivehlh/$name
else
	echo "Container mine is not start!, starting"
	docker run -d --name $name -p 3000:80 detectivehlh/$name
	echo "Finish starting"
fi
docker images | grep none | awk '{print $3}' | xargs docker rmi

6. 如果你只是想打個包

看到標題進來的兄dei,如果只是想打包一個docker鏡像,那么你只需要Dockerfile文件和docker build命令就OK了。

7. 總結

最初寫這個腳本,主要目的是為了方便。所以腳本中為了達到這個目的做了一些調整。最終我達成了滿足我需求的一個方便的部署腳本。

它的方便體現在,當我完成了項目代碼的更新,只需要跑一下這個腳本,然后等待一會兒,項目就會自動打包成docker image,並且自動的在我的服務器上運行該container。

但是這種方式會給實際的生產環境帶來一些不可控的問題。比如,腳本必須不能上傳,因為涉及一些服務器的敏感信息。但是如果你不小心上傳了,那你的服務器就相當於裸奔了;再比如,你對你的代碼必須要十分自信,沒有經過測試的代碼就直接部署,會帶來一些風險。

如果是自己用的,那完全不用擔心,想怎么搞怎么搞。但是如果是開放給所有人用的並且有一定的訪問量,比如博客,那么對於其他用戶來說,這種方式就不怎么友好。

所以我的觀點是,分情況來。目前來說我的項目只有少數幾個人在用,也還在處於迭代階段。並且代碼倉庫是私有的,所以我完全不用擔心隱私的問題。服務未經測試就直接上線對於我來說,其實問題也不大。首先我會在本地測試,確認無誤后才會執行部署操作。所以在不同的階段,找到最適合自己的方案就OK。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM