最近一直在研究docker和kubernetes,小型的項目其實也用不到k8s,本文就是描述如何用jenkins 進行構建asp.net core 3.1項目並且發布到遠程服務器docker容器中。本文也是對自己學習過程中的記錄。
本文包含以下技術點:
1、CentOS 7 安裝Jenkins與必要的配置
2、CentOS 7 安裝 Git 與 dotnet core sdk
3、Jenkins全局配置與構建任務的配置
一、CentOS 7 安裝Jenkins與必要的配置
首先需要安裝java環境,因為Jenkins基於java。java的安裝可參考 :https://www.cnblogs.com/stulzq/p/9286878.html
可以去Jenkins官網去下載rpm包,但是網速太慢了,這里推薦用 清華大學開源軟件鏡像站 去下載 Jenkins的rpm包。如下圖:
這里下載2.223的最新版本,在centos 中使用: sudo wget https://mirrors4.tuna.tsinghua.edu.cn/jenkins/redhat/jenkins-2.223-1.1.noarch.rpm 命令進行下載:
然后使用命令:rpm -ivh jenkins-2.223-1.1.noarch.rpm 安裝
配置jenkins 用戶為root,這里可以避免很多權限問題,如下圖:
使用命令 systemctl restart jenkins 重啟jenkins。然后使用命令:systemctl status jenkins 查看下jenkins是否正常啟動,如下圖:
這時,我們就可以通過 http://ip:8080 進行訪問了。具體的初始化配置,這里就略過,可以自行百度。
初始化jenkins的過程中,jenkins會讓我們安裝一些 推薦的插件,我們選擇后,有些插件會安裝失敗,是因為軟件源的問題。我們可以選擇跳過,然后進入jenkins。
這里可以在 系統管理--》插件管理--》高級 選項卡中 的配置中,配置清華軟件鏡像站的地址 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json,替換官方默認的地址,
然后我們再修復插件的安裝。如下圖:
我們利用jenkins構建完asp.net core 程序后,需要將發布好的文件推送到遠程linux服務器中,還需要遠程執行腳本,操作遠程服務器的Docker,這時我們需要安裝插件 Publish Over SSH
在 系統管理--》插件管理--》可選插件 選項卡中搜索該插件並進行安裝。到這來我們就完成了 CenrOS 安裝jenkins 並進行了一些初始化的配置。
二、CentOS 7 安裝 Git 與 dotnet core sdk
我們需要利用jenkins 調用 git 去下載代碼,這時我們肯定需要事先安裝git。執行 yum install -y git 命令進行安裝。
我們還需要利用jenkins執行 asp.net core 3.1 的Build 與 發布操作,我們也需要事先安裝好 dotnet core 3.1 sdk 具體安裝過程可參考微軟官方文檔:
https://docs.microsoft.com/zh-cn/dotnet/core/install/linux-package-manager-centos7
三、Jenkins全局配置與構建任務的配置
我們在上面的配置過程中安裝了jenkins 需要用到的 git 以及publish over ssh 插件,在用這兩個之前,我們需要在jenkins中進行一些全局的配置。
首先我們來看git的配置,在Jenkins 系統管理--》全局工具配置 我們需要輸入git 的安裝位置,如下圖:
我們再來看 publish over ssh 插件的配置,在 系統管理--》系統配置 中,如下圖:
上面的 Remote Directory 需要輸入遠程服務器的文件夾,該文件夾表示上傳文件的存放目錄
到這里,我們就可以開始新建 jenkins的構建任務了,我們可以點擊新建任務,輸入一個名字,選擇自由風格的軟件項目,如下圖:
在源碼管理中,輸入你項目的git 地址以及添加一個對應的git的用戶名和密碼憑據 信息, 如下圖:
在構建環境中,我們勾選以下配置:
在勾選的 Send files or execute commands over SSH after the build runs 中,SSH Server 就是我們在上一步在全局配置中配置的 publish over ssh 的ssh 名字。
Source files 是我們需要上傳的文件,這里我們利用 dotnet 命令發布 asp.net core 項目,然后壓縮成 tar.gz 的壓縮文件,所以這里配置 **/.tar.gz ,**/ 是你當前構建項目jenkins的
工作目錄。
在構建 中,我們選擇 執行 shell ,如下圖:
cd /var/lib/jenkins/workspace/test/aspnetweb
dotnet publish -c Release -o published
tar -czvf published.tar.gz published
命令總共三行,首先進入jenkins的工作目錄,然后在該目錄下,執行dotnet 發布命令,發布到published 文件夾
最后將 published 文件夾 進行壓縮成 published.tar.gz
我們再選擇 構建后操作,選擇 Send build artifacts over ssh,如下圖:
上圖中的 SSH server 也是我們再全局配置中配置的,Source files 是我們要上傳的文件,Exec command 是要在遠程服務器執行的 腳本命令:
cd /root/remote/aspnetweb
tar -xvzf published.tar.gz
cd /root/remote/aspnetweb/published
docker stop aspnetweb
docker rm aspnetweb
docker rmi aspnetweb
docker build -t aspnetweb .
docker run -d -p:5001:80 --name aspnetweb aspnetweb
這里 我們也是進入到 遠程服務器的 目錄,解壓上傳的文件,然后 進行基本的 docker 容器操作。
在這里 我們發布的 asp.net core 目錄中有一個 Dockerfile 文件,docker 才能進行 新的鏡像的 build,Dockerfile 的文件內容如下:
FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 AS runtime
WORKDIR /app
COPY . ./
ENTRYPOINT ["dotnet", "aspnetweb.dll"]
這里需要我們的遠程服務器,安裝docker,以及事先 docker pull mcr.microsoft.com/dotnet/core/aspnet:3.1 的鏡像。
--------
參考文章:https://www.cnblogs.com/stulzq/p/9291237.html