本文以部署 Spring boot + Maven 項(xiàng)目為例,使用碼云作為代碼托管倉(cāng)庫(kù),在 CentOS 7 上搭建 Jenkins 持續(xù)集成環(huán)境。
1. 準(zhǔn)備工作
1.1 安裝 Java 環(huán)境
Jenkins 是基于 Java 開(kāi)發(fā)的持續(xù)集成工具,需要在 Java 環(huán)境下運(yùn)行。用下面命令查看系統(tǒng)是否已安裝 Java:
yum list installed | grep jdk
如果沒(méi)有,使用 yum search 命令查找 openjdk 版本,選擇合適的 jdk 進(jìn)行安裝:
yum search openjdk
yum -y install java-1.8.0-openjdk-devel
驗(yàn)證 Java 是否安裝成功:
1.2 安裝 Maven
依次運(yùn)行以下兩條命令:
wget http://repos.fedorapeople.org... -O /etc/yum.repos.d/epel-apache-maven.repo
yum -y install apache-maven
驗(yàn)證 Maven 是否安裝成功:
1.3 安裝 Git
直接通過(guò) yum 安裝,安裝完成后查看版本驗(yàn)證是否安裝成功:
yum -y install git
git --version
2. 安裝和配置 Jenkins:
2.1 安裝 Jenkins
依次運(yùn)行以下三條命令:
sudo wget https://pkg.jenkins.io/redhat... -O /etc/yum.repos.d/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat...
yum -y install jenkins
如果之前從 Jenkins 導(dǎo)入過(guò) key,那么 rpm --import 將失敗,因?yàn)橐呀?jīng)有一個(gè) key 了。忽略它,繼續(xù)執(zhí)行 install 即可。
2.2 啟動(dòng) Jenkins
啟動(dòng) Jenkins,并且設(shè)置開(kāi)機(jī)自啟動(dòng):
systemctl start jenkins.service
chkconfig jenkins on
Jenkins 默認(rèn)使用8080端口,訪問(wèn)以下鏈接即可看到 Jenkins 的 Web 界面:
http://<服務(wù)器地址>:8080
如果無(wú)法訪問(wèn),檢查一下防護(hù)墻,是否有開(kāi)放端口,或使用命令 netstat -ntulp 查看端口是否被占用。
2.3 進(jìn)入 Jenkins
首次進(jìn)入 Jenkins 需要輸入管理員密碼,使用以下命令查看初始密碼:
cat /var/lib/jenkins/secrets/initialAdminPassword
選擇默認(rèn)的 install suggested plugins
安裝插件,等待安裝完成后依照步驟創(chuàng)建用戶,創(chuàng)建完成后即可登入。
2.4 配置 Jenkins
進(jìn)入 Manage Jenkins
-> Global Tool Configuration
,依次配置 JDK、Git 和 Maven 路徑。
2.4.1 查看 JDK 路徑
使用 yum 安裝的軟件不會(huì)幫我們配置環(huán)境變量,直接使用命令echo $JAVA_HOME 是看不到路徑的。
先用以下命令查看路徑:
看到的結(jié)果是 /usr/bin/java ,但實(shí)際上這只是個(gè)軟連接,并不是 JDK 真正的所在目錄。
繼續(xù)使用以下命令查看:
看到 /usr/bin/java 指向了 /etc/alternatives/java,很遺憾,還不是我們要找的真正路徑。
繼續(xù)追蹤:
ls -l /etc/alternatives/java
結(jié)果指向了 /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.191.b12-1.el7_6.x86_64/jre/bin/java
,不同版本的 JDK 目錄名可能有些不同,這就是 JDK 真正所在的地方。
![](/d/20211016/67cfbaff1494c03ecca0b9ddb85949cc.gif)
同理可獲得 Maven 的所在路徑。
![](/d/20211016/5dcaa7c241f5b3e213986bf867c2e3fb.gif)
![](/d/20211016/feb8b26a34f720e2e6e3df92b1f9cbaf.gif)
![](/d/20211016/acb060d265c69e8b31f64cf02113bd0e.gif)
2.4.2 安裝和配置插件
進(jìn)入 Manage Jenkins
-> Manage Plugins
,搜索并安裝 Publish Over SSH
和 Maven Integration
兩個(gè)插件, Git Plugins
插件已經(jīng)默認(rèn)安裝上了,我們無(wú)需再安裝。
配置 SSH 免密碼登錄
在配置插件之前,我們先在 Jenkins 服務(wù)器上生成密鑰對(duì)。運(yùn)行以下命令切換到 jenkins 用戶:
如果無(wú)法切換,則打開(kāi) /etc/passwd 文件,找到 jenkins 那一行,將 /bin/fasle 改成 /bin/bash。
切換成功后,命令提示符的用戶名可能是 bash-4.2$,想要正常顯示用戶名的話,先切換回 root 用戶,執(zhí)行以下操作:
編輯文件 vi ~/.bash_profile
加入語(yǔ)句 export PS1='[u@h W]$'
立即生效 source ~/.bash_profile
再切換到 jenkins 用戶,就顯示正常了。接下來(lái)運(yùn)行以下命令生成密鑰對(duì):
一路按回車完成,會(huì)在 /var/lib/jenkins/.ssh/ 目錄下生成 id_rsa 和 id_rsa.pub兩個(gè)文件。
將 id_rsa.pub 文件里的內(nèi)容追加到應(yīng)用服務(wù)器上的 /root/.ssh/authorized_keys 文件末尾,每行一個(gè) key,注意是應(yīng)用服務(wù)器。重啟應(yīng)用服務(wù)器上的 ssh 服務(wù):
systemctl restart sshd.service
現(xiàn)在 Jenkins 可以免密碼登錄應(yīng)用服務(wù)器了,以 jenkins 用戶身份運(yùn)行命令來(lái)測(cè)試一下:
ssh root@<應(yīng)用服務(wù)器地址>
首次連接會(huì)有確認(rèn)提示,輸入 yes 即可。這步很重要,如果第一次沒(méi)有手動(dòng)連接確認(rèn),Jenkins 會(huì)連不上。
配置 Public over SSH 插件
進(jìn)入 Manage Jenkins
-> Configure System
,填寫 Publish over SSH
設(shè)置。
![](/d/20211016/5f31fe451faf3d36b93baa2fc2a6ba1c.gif)
Path to key:填寫剛剛生成的 id_rsa 密鑰文件的路徑。
Name:服務(wù)名,隨意填寫。
HostName:應(yīng)用服務(wù)器的 IP 地址或域名。
Username:登錄應(yīng)用服務(wù)器的用戶身份。
Remote Directory:遠(yuǎn)程目錄, 應(yīng)用服務(wù)器上存放應(yīng)用的目錄,Jenkins 會(huì)把應(yīng)用拷貝至此目錄下。請(qǐng)確保此目錄存在。
save~
3. 部署 Maven 項(xiàng)目
點(diǎn)擊 New Item 新建任務(wù),隨意輸入任務(wù)名,選擇 Maven project, ok。
在General,勾選 Discard old builds,可以設(shè)置最多保留構(gòu)建文件多少天,和最多保留多少個(gè)構(gòu)建文件,不然每次構(gòu)建生成的文件都會(huì)保留,占用磁盤空間。
![](/d/20211016/6396aefc7128ea62b35811d127bc6bb7.gif)
配置遠(yuǎn)程代碼倉(cāng)庫(kù)地址,Jenkins 會(huì)從該地址拉取代碼。注意此處如果提示無(wú)法讀取倉(cāng)庫(kù),有可能是:
- 公鑰沒(méi)有添加到遠(yuǎn)程代碼服務(wù)器的 authorized_keys 文件里,上面配置 SSH 免登錄是 Jenkins 訪問(wèn)應(yīng)用服務(wù)器的,Jenkins 訪問(wèn)代碼服務(wù)器也同樣需要配置,除非應(yīng)用服務(wù)器和代碼服務(wù)器是同一臺(tái)機(jī)器。如果使用碼云或 GitHub 等代碼托管平臺(tái),會(huì)有相應(yīng)的 SSH key 設(shè)置頁(yè)。
- 公鑰已添加到相應(yīng)文件里,但沒(méi)有手動(dòng)連接第一次。解決方法很簡(jiǎn)單,以 jenkins 用戶身份手動(dòng) clone 一次倉(cāng)庫(kù),確認(rèn) yes 即可。
![](/d/20211016/558384365d456efb3d98831a887897ea.gif)
勾選 Add timestamps to the Console Output
,在控制臺(tái)輸出構(gòu)建過(guò)程。
![](/d/20211016/ad6dfcc21637afd83eaa6a2962d9c84d.gif)
填寫 Maven 打包指令,-DMaven.test.skip=true 表示跳過(guò)測(cè)試。
![](/d/20211016/3c5b942bc8a79d64e6dc27659297a590.gif)
勾選 Run only if build succeeds
,選擇 Send files or execute commands over SSH
。
![](/d/20211016/0a3569a2c7600917991410432efabfad.gif)
接下來(lái)就是設(shè)置 build 完之后,把 jar 包從 Jenkins 服務(wù)器拷貝到應(yīng)用服務(wù)器上,并運(yùn)行。
![](/d/20211016/4642d75884fd3cf6a63142497d67027f.gif)
Name:選擇之前創(chuàng)建的服務(wù)。
Source files:maven 打包后生成的 jar 包,即要拷貝到應(yīng)用服務(wù)器運(yùn)行的程序,可填多個(gè),英文逗號(hào)分隔。
Remove prefix:忽略前綴,我們只需要拷貝 target 下的 jar 包,不需要在應(yīng)用服務(wù)器上生成 target 目錄。
Remote directory:目標(biāo)文件夾,會(huì)繼承全局設(shè)置,例如此處會(huì)把 jar 包拷貝到 /usr/local/app/demo 目錄下。
Exec command:拷貝完成后,在應(yīng)用服務(wù)器上執(zhí)行的命令或腳本。
save
-> build now
,構(gòu)建成功后,打開(kāi)瀏覽器訪問(wèn)你的站點(diǎn)吧~
4. 總結(jié)
其實(shí)整個(gè)流程不是很復(fù)雜,Jenkins 從遠(yuǎn)程代碼庫(kù)拉取代碼 -> 調(diào)用 maven 指令將項(xiàng)目打包 -> Jenkins 將打包好的文件拷貝到遠(yuǎn)程應(yīng)用服務(wù)器 -> 在遠(yuǎn)程應(yīng)用服務(wù)器上執(zhí)行 shell 指令,啟動(dòng)程序。其中 Jenkins 兩次遠(yuǎn)程操作都是通過(guò) SSH 完成的。
通過(guò) yum 安裝 Jenkins 和 Java 比較方便,但是在配置的時(shí)候相對(duì)麻煩,安裝路徑要自己找,配置 SSH 的時(shí)候也是要用 jenkins 用戶身份,而不是 root,如果采用解壓縮包的方式就比較自由一些。
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。