三十二張圖告訴你，Jenkins構建Spring Boot 有多簡單~

持續原創輸出,點擊上方藍字關注我

前言
如何安裝Jenkins？
- 環境準備
- 開始安裝Jenkins
初始化配置
- 訪問首頁
- 輸入管理員密碼
- 安裝插件
- 創建管理員
- 實例配置
- 配置完成
構建Spring Boot 項目
- 配置JDK、maven、Git環境
- 安裝插件
- 添加 SSH Server
- 添加憑據
- 新建Maven項目
- 構建任務
如何構建託管在GitLab的項目？
- 安裝插件
- 添加GitLab API token
- 配置GitLab插件
- 新建任務
- 後續操作
多模塊項目如何構建？
總結

前言

自動持續集成不知道大傢伙有沒有聽說過，有用過類似的工具嗎？

簡而言之，自動持續集成的工作主要是能對項目進行構建、自動化測試和發佈。

今天這篇文章就來講講常用的持續集成的工具Jenkins以及如何自動構建Spring Boot項目。

如何安裝Jenkins？

Jenkins是Java開發的一套工具，可以直接下載war包部署在Tomcat上，但是今天作者用最方便、最流行的Docker安裝。

環境準備

在開始安裝之前需要準備以下環境和工具：

一臺服務器，當然沒有的話可以用自己的電腦，作者的服務器型號是Ubuntu。
JDK環境安裝，作者的版本是1.8，至於如何安裝，網上很多教程。
準備maven環境，官網下載一個安裝包，放在指定的目錄下即可。
Git環境安裝，網上教程很多。
代碼託管平臺，比如Github、GitLab等。

開始安裝Jenkins

Docker安裝Jenkins非常方便，只要跟着作者的步驟一步步操作，一定能夠安裝成功。

Docker環境安裝

每個型號服務器安裝的方式各不相同，讀者可以根據自己的型號安裝，網上教程很多。

拉取鏡像

我這裏安裝的版本是jenkins/jenkins:2.222.3-centos，可以去這裏獲取你需要的版本: https://hub.docker.com/_/jenkins?tab=tags。執行如下命令安裝：

docker pull jenkins/jenkins:2.222.3-centos

創建本地數據卷

在本地創建一個數據卷掛載docker容器中的數據卷，我創建的是/data/jenkins_home/，命令如下：

 mkdir -p /data/jenkins_home/

需要修改下目錄權限，因爲當映射本地數據卷時，/data/jenkins_home/目錄的擁有者爲root用戶，而容器中jenkins用戶的 uid 爲 1000。

chown -R 1000:1000 /data/jenkins_home/

創建容器

除了需要掛載上面創建的/data/jenkins_home/以外，還需要掛載maven、jdk的根目錄。啓動命令如下：

docker run -d --name jenkins -p 8040:8080 -p 50000:50000 -v /data/jenkins_home:/var/jenkins_home -v /usr/local/jdk:/usr/local/jdk -v /usr/local/maven:/usr/local/maven jenkins/jenkins:2.222.3-centos

以上命令解析如下：

-d：後臺運行容器
--name：指定容器啓動的名稱
-p：指定映射的端口，這裏是將服務器的8040端口映射到容器的8080以及50000映射到容器的50000。 「注意：」 8040和50000一定要是開放的且未被佔用，如果用的是雲服務器，還需要在管理平臺開放對應的規則。
-v：掛載本地的數據捲到docker容器中，「注意：」 需要將JDK和maven的所在的目錄掛載。

初始化配置

容器啓動成功，則需要配置Jenkins，安裝一些插件、配置遠程推送等等。

訪問首頁

容器創建成功，訪問http://ip:8040，如果出現以下頁面表示安裝成功：

輸入管理員密碼

啓動成功，則會要求輸入密碼，如下圖：

這裏要求輸入的是管理的密碼，提示是在/var/jenkins_home/secrets/initialAdminPassword，但是我們已經將/var/jenkins_home這個文件夾掛載到本地目錄了，因此只需要去掛載的目錄/data/jenkins_home/secrets/initialAdminPassword文件中找。

輸入密碼，點擊繼續。

安裝插件

初始化安裝只需要安裝社區推薦的一些插件即可，如下圖：

這裏選擇安裝推薦的插件，然後 Jenkins 會自動開始安裝。

「注意：」 如果出現想插件安裝很慢的問題，找到/data/jenkins_home/updates/default.json文件，替換的內容如下：

將 updates.jenkins-ci.org/download 替換爲mirrors.tuna.tsinghua.edu.cn/jenkins
將 www.google.com 替換爲www.baidu.com。

執行以下兩條命令：

sed -i 's/www.google.com/www.baidu.com/g' default.json

sed -i 's/updates.jenkins-ci.org\/download/mirrors.tuna.tsinghua.edu.cn\/jenkins/g' default.json

全部安裝完成，繼續下一步。

創建管理員

隨便創建一個管理員，按要求填寫信息，如下圖：

實例配置

配置自己的服務器IP和端口，如下圖：

配置完成

按照以上步驟，配置完成後自動跳轉到如下界面：

構建Spring Boot 項目

在構建之前還需要配置一些開發環境，比如JDK，Maven等環境。

配置JDK、maven、Git環境

Jenkins集成需要用到maven、JDK、Git環境，下面介紹如何配置。

首先打開系統管理->全局工具配置，如下圖：

分別配置JDK，Git，Maven的路徑，根據你的實際路徑來填寫。

「注意」：這裏的JDK、Git、Maven環境一定要掛載到docker容器中，否則會出現以下提示：

 xxxx is not a directory on the Jenkins master (but perhaps it exists on some agents)

配置成功後，點擊保存。

安裝插件

除了初始化配置中安裝的插件外，還需要安裝如下幾個插件：

Maven Integration
Publish Over SSH

打開系統管理 -> 插件管理，選擇可選插件，勾選中 Maven Integration 和 Publish Over SSH，點擊直接安裝。

在安裝界面勾選上安裝完成後重啓 Jenkins。

添加 SSH Server

SSH Server 是用來連接部署服務器的，用於在項目構建完成後將你的應用推送到服務器中並執行相應的腳本。

打開 系統管理 -> 系統配置，找到 Publish Over SSH 部分，選擇新增

點擊 高級 展開配置

最終配置如下：

配置完成後可點擊 Test Configuration 測試連接，出現 success 則連接成功。

添加憑據

憑據是用來從 Git 倉庫拉取代碼的，打開 憑據 -> 系統 -> 全局憑據 -> 添加憑據

這裏配置的是Github，直接使用用戶名和密碼，如下圖：

創建成功，點擊保存。

新建Maven項目

以上配置完成後即可開始構建了，首先需要新建一個Maven項目，步驟如下。

創建任務

首頁點擊新建任務->構建一個maven項目，如下圖：

源碼管理

在源碼管理中，選擇Git，填寫倉庫地址，選擇之前添加的憑證。

構建環境

勾選 Add timestamps to the Console Output，代碼構建的過程中會將日誌打印出來。

構建命令

在Build中，填寫 Root POM 和 Goals and options，也就是你構建項目的命令。

Post Steps

選擇Run only if build succeeds，添加 Post 步驟，選擇 Send files or execute commands over SSH。

上圖各個選項解析如下：

name:選擇前面添加的SSH Server
Source files:要推送的文件
Remove prefix:文件路徑中要去掉的前綴，
Remote directory:要推送到目標服務器上的哪個目錄下
Exec command:目標服務器上要執行的腳本

Exec command指定了需要執行的腳本，如下：

# jdk環境，如果全局配置了，可以省略
export JAVA_HOME=/xx/xx/jdk
export JRE_HOME=/xx/xx/jdk/jre
export CLASSPATH=/xx/xx/jdk/lib
export PATH=$JAVA_HOME/bin:$JRE_HOME/bin:$PATH
 
# jenkins編譯之後的jar包位置，在掛載docker的目錄下
JAR_PATH=/data/jenkins_home/workspace/test/target
# 自定義的jar包位置
DIR=/data/test

## jar包的名稱
JARFILE=swagger-demo-0.0.1-SNAPSHOT.jar

if [ ! -d $DIR/backup ];then
   mkdir -p $DIR/backup
fi

ps -ef | grep $JARFILE | grep -v grep | awk '{print $2}' | xargs kill -9

if [ -f $DIR/backup/$JARFILE ]; then
 rm -f $DIR/backup/$JARFILE
fi

mv $JAR_PATH/$JARFILE $DIR/backup/$JARFILE


java -jar $DIR/backup/$JARFILE > out.log &
if [ $? = 0 ];then
        sleep 30
        tail -n 50 out.log
fi

cd $DIR/backup/
ls -lt|awk 'NR>5{print $NF}'|xargs rm -rf