在前後端分離開發的項目當中為了避免重覆構建發佈,我們需要部署一個持續發佈環境,而目前的開發環境伺服器 都是基於 CentOS 的,因此每次在本地發佈之後還需要打包,上傳,部署,十分繁瑣。故這裡採用了比較成熟的 Jenkins 作為持續部署環境。 為了方便安裝,我們這裡使用了 Docker 來進行安裝 ...
在前後端分離開發的項目當中為了避免重覆構建發佈,我們需要部署一個持續發佈環境,而目前的開發環境伺服器都是基於 CentOS 的,因此每次在本地發佈之後還需要打包,上傳,部署,十分繁瑣。故這裡採用了比較成熟的Jenkins 作為持續部署環境。
為了方便安裝,我們這裡使用了 Docker 來進行安裝,至於 Docker 安裝的步驟這裡不在贅述,詳情可以參考這一篇博文。
上面安裝的是一個較老的版本,這裡推薦參考Docker 官方文檔來進行安裝。
安裝好 Docker 之後,拉取 Jenkins 的官方鏡像。執行如下命令:
docker pull jenkins/jenkins
拉取完畢之後我們基於這個鏡像封裝一個新的鏡像出來,可能會問為什麼不能直接使用呢?因為這兒的 jenkins鏡像並不包含 docker 環境,所以我們需要封裝一個新的鏡像讓其能夠訪問宿主機的 Docker 程式。
構建 Dockerfile 內容如下:
FROM jenkins/jenkins:latest
USER root
#清除了基礎鏡像設置的源,切換成阿裡雲的源
RUN echo '' > /etc/apt/sources.list.d/jessie-backports.list \
&& echo "deb http://mirrors.aliyun.com/debian jessie main contrib non-free" > /etc/apt/sources.list \
&& echo "deb http://mirrors.aliyun.com/debian jessie-updates main contrib non-free" >> /etc/apt/sources.list \
&& echo "deb http://mirrors.aliyun.com/debian-security jessie/updates main contrib non-free" >> /etc/apt/sources.list
#更新源並安裝缺少的包
RUN apt-get update && apt-get install -y libltdl7
ARG dockerGid=999
RUN echo "docker:x:${dockerGid}:jenkins" >> /etc/group \
USER jenkins
完成之後執行如下命令構建新的 Docker 鏡像:
docker build -t docker/jenkins .
下麵我們就開始運行我們的 Jenkins 容器了:
docker run -d -p 8080:8080 -p 50000:50000 \
--name=jenkins -v /root/docker/jenkins:/var/jenkins_home \
-v /var/run/docker.sock:/var/run/docker.sock \
-v $(which docker):/usr/bin/docker \
docker/jenkins
這裡我們將 Jenkins 鏡像裡面的 /var/jenkins_home 映射到了宿主機的 /root/docker/jenkins 文件夾,在這個文件夾裡面都存放的是 Jenkins 的一些配置項等。
註意,這裡可能會出現如下錯誤:
touch: cannot touch ‘/var/jenkins_home/copy_reference_file.log’: Permission denied
Can not write to /var/jenkins_home/copy_reference_file.log. Wrong volume permissions?
這是因為在 docker 內部的 jenkins user 用戶沒有許可權,因為映射的 /root/docker/jenkins/ 文件夾屬於root 用戶的,而 jenkins user 的 uid 為 1000,執行如下命令:
sudo chown -R 1000:1000 /home/docker/jenkins
之後再次運行 Jenkins 的容器,訪問 http://伺服器IP:8080/ 站點,會提示你輸入密鑰:
我們來到宿主機執行以下 shell 命令:
docker container logs jenkins
就可以看到密鑰其實已經輸出在終端了,複製過來,粘貼進去就可以了。之後就是選擇你需要安裝的插件,選擇第一個預設即可,可能這裡因為網路原因會安裝失敗,可以多重試幾次,或者直接忽略掉,後面我們會將如何解決。
安裝完成之後輸入用戶名密碼,就可以開始使用了,可能你剛纔會因為網路等原因造成插件安裝失敗,這裡我們來到
Jenkins>>系統管理>>管理插件>>高級
然後將 升級站點 地址改為 http://mirror.xmission.com/jenkins/updates/current/update-center.json。之後安裝之前缺失的插件。
這裡我們項目使用的是 TFS 進行源代碼管理,所以我們需要安裝 TFS 插件,在 Manage Jenkins 的 Manage Plugin 裡面我們找到 Team Foundation Server Plug-in 插件,勾選,點擊 Download now and install after restart 按鈕,勾選 Restart Jenkins when installation is complete and no jobs are running 。
安裝完成之後 Jenkins 會重啟,等待重啟完畢之後,來到 Jenkins>>Manage Jenkins>>Configure System 查看 TFS/Team Services 然後添加你的 TFS Collection。
保存之後我們就可以新建項目了。
首先,我們來到首頁,選擇 New Item:
然後選擇自由風格項目,填上名稱.
在 Source Code Management 上選擇 TFS,並且填入你的 TFS 伺服器地址,項目路徑,與你的賬號密碼:
然後你就可以嘗試構建一下,構建成功之後就會在 Workspace 看到你的項目文件被拉下來了。
那麼我們的代碼如何構建並且部署呢?因為我們之前在 Jenkins 的 Docker 鏡像啟動的時候掛載了宿主機的 Docker 程式,我們現在就可以直接基於微軟的 dotnetcore 鏡像來構建我們的項目。所以,我們先拉取微軟的 dotnetcore 鏡像,運行如下命令:
docker pull microsoft/dotnet:latest
拉取鏡像之後,我們來編寫一個 Dockerfile 文件來讓 Jenkins 來執行 Shell 構建。
如果你還不知道如何編寫 Dockerfile 文件,可以參考 這篇文章。
FROM microsoft/dotnet:latest
WORKDIR /app
COPY ./ .
ENV ASPNETCORE_URLS http://+:5000
EXPOSE 5000
RUN cd ./HKERP.IdentityServer.Host \
&& dotnet restore \
&& dotnet build
WORKDIR /app/HKERP.IdentityServer.Host
ENTRYPOINT ["dotnet","run"]
然後將這個 Dockerfile 放在你的項目裡面,類似於這樣:
然後我們再回到剛纔 Jenkins 裡面,配置剛纔項目,新建一個 Shell Step,就像這樣:
代碼如下:
#!/bin/sh
cd /var/jenkins_home/workspace/API_IdentityServer
docker container prune << EOF
y
EOF
docker container ls -a | grep "api_identityserver"
if [ $? -eq 0 ];then
docker container stop api_identityserver
docker container rm api_identityserver
fi
docker image prune << EOF
y
EOF
docker build -t api_identityserver .
docker run -d -p 8083:5000 --name=api_identityserver api_identityserver
步驟就是首先清理掉 docker 處於終止狀態的容器,然後判斷有沒有叫 api_identityserver 的容器在運行,如果有就直接停掉,然後清除所有的虛懸鏡像,使用當前目錄的 dockerfile 構建一個新的 api_identityserver 鏡像,使用 api_identityserver 鏡像運行一個新的容器。
這兒我安裝了 Jenkins 的一個 Blue Ocean 插件,來看一下:
運行一下: