Linux下使用Jenkins自動化構(gòu)建.NET?Core應(yīng)用
部署 Jenkins
請?zhí)崆霸?Linux 上安裝 Docker,在 Linux 中,我們使用 Docker 啟動 Jenkins,這樣可以避免手動安裝大量依賴以及污染本地環(huán)境,也便于快速啟動和故障恢復(fù)。
安裝 Docker 完畢后,使用 docker version
檢查 Docker 版本,Docker 版本不能為 1.x、3.x 這種版本,請升級到 18.x 以上版本。一般在 Ubuntu 系統(tǒng)中,下載安裝的是最新版本,但是在 Centos 中因為默認鏡像源中的版本比較舊, 安裝 Doker 版本較低,需要手動添加新版本的鏡像源再升級。
請參考:http://www.dbjr.com.cn/article/243104.htm
因為會使用到容器提供環(huán)境,以及使用 Docker 打包 .NET Core 程序為 Docker 鏡像,所以需要在 Jenkins 容器中映射 Docker 的 .sock
文件,以便在容器中,還能使用 Docker 命令。
在宿主機中創(chuàng)建 /var/jenkins_home
目錄,用于備份 Jenkins 中的數(shù)據(jù)。
在 Linux 中使用 Docker 啟動 Jenkins ,其命令如下:
docker run \ -u root \ -itd \ -p 8080:8080 \ -p 50000:50000 \ -v /var/jenkins_home:/var/jenkins_home \ -v /var/run/docker.sock:/var/run/docker.sock \ jenkinsci/blueocean
啟動后,使用 docker logs {容器ID}
查看日志獲取 Jenkins 登錄密碼,其密碼是一串哈希字符串,例如:1abc12445adcf
。
最后打開 8080
端口,即可訪問 Jenkins。
安裝插件
登錄 Jenkins 后,會提示安裝推薦的插件,請根據(jù)提示安裝推薦的插件,推薦安裝的插件列表如下:
Folders Plugin OWASP Markup Formatter Plugin Build Timeout Credentials Binding Plugin Timestamper Workspace Cleanup Ant Gradle Pipeline GitHub Branch Source Plugin Pipeline: GitHub Groovy Libraries Pipeline: Stage View Git plugin SSH Build Agents Matrix Authorization Strategy Plugin PAM Authentication LDAP Email Extension Mailer Plugin Localization: Chinese (Simplified)
另外為了提供容器打包支持等,需要另外手工安裝以下插件。
# 提供 Docker 支持(必裝) docker Docker Pipeline docker-build-step # 可視化設(shè)計流水線腳本的工具(必裝) Blue Ocean # 提供對 gitlab 支持,如果不使用可以不安裝 gitlab # 提供 Git 參數(shù)化和鉤子觸發(fā)構(gòu)建支持,不需要可以不安裝 Git Parameter Generic Webhook Trigger
拉取鏡像
這里介紹一下我們后面要用到的兩個鏡像。
拉取一個 .NET Core SDK,每次啟動流水線時,都會啟動一個 .NET Core SDK 容器,為我們提供構(gòu)編譯、發(fā)布 .NET Core 程序的環(huán)境。
docker pull mcr.microsoft.com/dotnet/sdk:3.1
拉取一個 ASP.NET Core Runtime,用于制作應(yīng)用鏡像的基礎(chǔ)鏡像。
docker pull mcr.microsoft.com/dotnet/aspnet:3.1
鏡像列表:
mcr.microsoft.com/dotnet/aspnet 3.1 ac199e8d6dff 2 weeks ago 208MB mcr.microsoft.com/dotnet/sdk 3.1 82e2a34647f0 2 weeks ago 710MB
制作 Jenkinsfile 腳本
筆者貼心地給各位同學(xué)準備了 Demo 項目,請到 https://github.com/whuanle/DotNetCoreJenkinsDemo 倉庫,fork 到你的倉庫,后續(xù)我們使用這個 ASP.NET Core 的 Demo 程序?qū)嵺`流程。
在項目文件中,可以找到一個 Jenkinsfile 文件,此文件為我們定義流水線的步驟。
我們看一下簡單的 Jenkinsfile 模板:
pipeline { stages { stage('Build') { steps { echo 'Building..' } } stage('Test') { steps { echo 'Testing..' } } stage('Deploy') { steps { echo 'Deploying....' } } } }
stages
中,定義流水線的階段,在模板中,一個定義了三個階段,分別是 Build
、Test
、Deploy
。
每個階段都可以定義多個步驟(steps
),每個步驟中都可以執(zhí)行多個不同類型的 step。
stage('Test') { steps { echo 'Testing..' } }
demo 中的 Jenkinsfile 比較簡單,我們可以找個 Publish
階段的內(nèi)容看一下:
stage('Publish') { steps { sh 'dotnet publish src/WebDemo -c Release' } }
其實很簡單,每個步驟執(zhí)行 shell 命令就行,我們可以使用 sh '...'
表示此步驟要執(zhí)行的 shell 命令。
接著我們看一下 Jenkinsfile 開頭的兩部分內(nèi)容。
// 全局環(huán)境變量 environment { IMAGENAME = 'webdemo' // 鏡像名稱 IMAGETAG = '1.0.0' // 鏡像標簽 APPPORT = '8089' // 應(yīng)用占用的端口 APPDIR = '/opt/app' // 應(yīng)用工作的目錄 } agent { docker { image 'mcr.microsoft.com/dotnet/sdk:3.1' args '-v /var/run/docker.sock:/var/run/docker.sock -v /usr/bin/docker:/usr/bin/docker' } }
environment
中,可以定義此次構(gòu)建過程的環(huán)境變量。
agent
則是節(jié)點選擇器,可以選擇在何種環(huán)境下啟動流水線,有 node
、docker
等類型。
構(gòu)建流水線
登錄到 Jenkins 網(wǎng)頁后臺,在左側(cè)菜單欄中點擊 New Item
,開始創(chuàng)建流水線。
Jenkins 有多種流水線風(fēng)格,還可以通過添加插件,來加入更多的流水線類型,我們主要了解 Freestyle project 、Pipeline、Multibranch Pipeline 即可。
Freestyle project
Freestyle project流水線 使用上比較自由,不需要對項目做更改即可創(chuàng)建流水線,可以添加很多選擇、配置。如果流程需要變化,改動比較麻煩。
Pineline、Multibranch Pipeline
他們都可以同時處理多個分支,這兩種都是依賴于項目中的 Jenkinsfile 文件。Multibranch Pipeline 好處是可以同時檢查多個分支,為每個分支創(chuàng)建構(gòu)建Job,而 Pipeline 會把多個分支放到一個 Job 中。
點擊 New Item
,創(chuàng)建流水線,選擇 Mutibranch Pipline。
添加 Git 源代碼 倉庫方式,我們可以自由選擇一種類型,建議使用 Single repository & branch
。
由于我們沒有添加密鑰,所以 Jenkins 無法訪問你的 Github 倉庫,所以需要添加一個可訪問的密鑰。
找一臺已經(jīng)安裝了 git 的電腦,生成公鑰私鑰,為 Jenkins 和 GitHub 之間提供加密連接。
執(zhí)行命令:
ssh-keygen -t rsa -b 2048 -C "email@example.com"根據(jù)提示,填寫要存放密鑰的路徑,如
D:/id_rsa
。執(zhí)行命令后,會生成兩個文件,
id_rsa
、id_rsa.pub
,復(fù)制 id_rsa (私鑰)中的內(nèi)容到 Jenkins 中。然后把
id_rsa.pub
(公鑰)的內(nèi)容添加到 Github 你的賬號中。
你可以使用多種方式添加認證方式,最簡單、安全的是密鑰,我們可以選擇 Secret file
,然后上傳私鑰,或者使用別的方式,這里就不贅述了。
然后選擇要發(fā)布的分支,最后直接保存即可。
然后回到主界面,打開 我們創(chuàng)建的流水線,點擊 Build Now
,即可啟動流水線。
構(gòu)建成功截圖:
在 Linux 服務(wù)器上,查看鏡像列表:
root@localhost ~ 19:54:20 # docker images REPOSITORY TAG IMAGE ID CREATED SIZE webdemo 1.0.0 79b636ddef73 2 minutes ago 208MB
可以看到,已經(jīng)自動打包應(yīng)用為鏡像,其鏡像名稱和版本號,都可以在 Jenkinsfile 中設(shè)置。
觀察
我們可以在構(gòu)建界面中,觀察每個步驟的日志。
在 Open Blue Ocean 中,有更加好看的 UI 和方便的工具。
可視化設(shè)計流水線步驟。
觀察構(gòu)建過程。
到此這篇關(guān)于Linux下使用Jenkins自動化構(gòu)建.NET Core應(yīng)用的文章就介紹到這了。希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
ASP.NET中FileUpload文件上傳控件應(yīng)用實例
本文主要介紹FileUpload文件上傳控件在實際開發(fā)中經(jīng)常遇到的問題并給出解決方法,希望對大家有所幫助。2016-04-04.Net行為型設(shè)計模式之命令模式(Command)
這篇文章介紹了.Net行為型設(shè)計模式之命令模式(Command),文中通過示例代碼介紹的非常詳細。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-05-05.Net Core使用SignalR實現(xiàn)斗地主游戲
本文詳細講解了.Net Core使用SignalR實現(xiàn)斗地主游戲的方法,文中通過示例代碼介紹的非常詳細。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-01-01ASP.NET?Core中的Configuration配置二
這篇文章介紹了ASP.NET?Core中的Configuration配置,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-04-04WPF使用ValidationRules對MVVM架構(gòu)數(shù)據(jù)驗證
這篇文章介紹了WPF使用ValidationRules對MVVM架構(gòu)數(shù)據(jù)驗證的方法,文中通過示例代碼介紹的非常詳細。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-01-01