Jenkins+Docker+Gitee+SpringBoot自動化部署

xiangzhihong發表於2022-03-01

當我們使用傳統的開發方式開發後臺系統時,每寫完一個功能點就需要重新執行一下專案,然後進行測試,如果是專案比較小還可以,但是如果專案比較大的話,由於涉及的人員比較多,這種開發方式就比較麻煩。基於此,我們就需要使用Jenkins配合Gitee搭建一個自動化部署平臺,並將程式碼託管到伺服器上,這樣減輕了本地的電腦壓力,也解放了部署的流程。

1, 搭建Jenkins平臺

首先,我們需要搭建一下Jenkins自動化構建平臺。首先,我們需要安裝Docker,然後在Docker中安裝Jenkins,安裝的命令如下:

# 安裝yum-utils工具
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
# 配置阿里雲的Docker Yum源
sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
# 安裝Docker
sudo yum install docker-ce docker-ce-cli containerd.io
# 啟動Docker
sudo systemctl start docker
# 配置開機自啟動
sudo systemctl enable docker

通過以上指令即可成功安裝Docker並啟動,接下來我們通過Docker執行Jenkins。

docker run \
  -d \
  --rm \
  -u root \
  -p 8080:8080 \
  -v /home/jenkins-data:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /opt/develop_resource/apache-maven-3.6.3:/usr/local/maven \
  -v "$HOME":/home \
  jenkinsci/blueocean

執行上述指令Docker會自動拉取Jenkins的映象並啟動,因為我們要部署的是SpringBoot,所以需要準備JDK和Maven環境,不過該Jenkins映象自帶了JDK環境,只需準備一下Maven即可,首先,下載Maven壓縮包,命令如下:

wget http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz

然後,使用命令解壓檔案。

tar -zxvf apache-maven-3.6.3-bin.tar.gz

解壓之後千萬要注意Maven所在的目錄,比如:

/opt/develop_resource/apache-maven-3.6.3

將它掛載到容器的目錄裡,-v /opt/develop_resource/apache-maven-3.6.3:/usr/local/maven這一條指令中的Maven目錄千萬記得換成自己的。現在,我們可以執行剛才的指令啟動Jenkins了,通過docker ps指令可以檢視容器是否啟動。

[root@10 /]# docker ps
CONTAINER ID   IMAGE                 COMMAND                  CREATED          STATUS         PORTS                                                  NAMES
dfa1b8b2c7a3   jenkinsci/blueocean   "/sbin/tini -- /usr/…"   15 seconds ago   Up 9 seconds   0.0.0.0:8080->8080/tcp, :::8080->8080/tcp, 50000/tcp   condescending_meitner

接下來,我們使用伺服器的ip加埠8080的方式訪問Jenkins。
在這裡插入圖片描述
管理員密碼可以在Jenkins的啟動日誌中檢視,使用docker logs dfa1b8b2c7a3檢視日誌:
在這裡插入圖片描述
密碼就是紅框中的字串,注意紅框下的一段提示:

This may also be found at: /var/jenkins_home/secrets/initialAdminPassword

意思是你可以在/var/jenkins_home/secrets/initialAdminPassword這個檔案中檢視到管理員密碼,不過這是Jenkins容器內的目錄,我們在啟動Jenkins的就掛載了Jenkins的關鍵目錄/var/jenkins_home,宿主機目錄為/home/jenkins-data,所以可以使用如下指令檢視管理員密碼。

cat /home/jenkins-data/secrets/initialAdminPassword

得到密碼後輸入到Jenkins頁面解鎖Jenkins,然後點選安裝推薦的外掛。
在這裡插入圖片描述
在這裡插入圖片描述
接下來,直接點選【下一步】。
在這裡插入圖片描述
在這裡插入圖片描述
到這一步,Jenkins平臺就可以正式使用了。

2, Jenkins平臺配置

接下來,就是對Jenkins平臺的配置,首先配置Maven。
在這裡插入圖片描述
按步驟點選,即可進入系統配置。首先,在全域性屬性中進行配置。
在這裡插入圖片描述
在這裡插入圖片描述
還記得我們在執行Jenkins容器時掛載的Maven目錄嗎?掛載到Jenkins容器中的目錄就是/usr/local/maven,如果實在搞不懂的你就保持和我的配置一樣即可。

以同樣的方式,再新增一個配置:
在這裡插入圖片描述
PATH+EXTRA的作用是讓原來PATH變數中的環境不丟失,最後點選儲存。Maven配置完成後,需要配置Gitee。
在這裡插入圖片描述
在這裡插入圖片描述
點選可選外掛,選中Gitee,然後點選Install without restart進行安裝,等待安裝完成即可,Gitee的相關配置我們放到後面講。

3,建立SpringBoot應用

首先,我們建立一個簡單的SpringBoot應用進行測試,控制器程式碼如下。

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello(){
        return "Hello World!";
    }
}

然後在配置檔案application.yml中新增:

server:
  port: 8000

並在main下新建docker資料夾,在docker資料夾下新建Dockefile檔案,內容如下。

# 指定是基於哪個基礎映象
FROM java:8

# 作者資訊
MAINTAINER wwj

# 掛載點宣告
VOLUME /tmp

# 將本地的一個檔案或目錄,拷貝到容器的檔案或目錄裡
ADD /target/demo-0.0.1-SNAPSHOT.jar springboot.jar

#shell指令碼
RUN bash -c 'touch /springboot.jar'

# 將容器的8000埠暴露,給外部訪問。
EXPOSE 8000

# 當容器執行起來時執行使用執行jar的指令
ENTRYPOINT ["java", "-jar", "springboot.jar"]

需要注意的是ADD指令的編寫,當SpringBoot應用打包完成後,其jar包會被放在target目錄下。
在這裡插入圖片描述
所以需要指定該檔案的位置,使用ADD指令將其放入待構建的容器中,接著在Gitee中新建一個倉庫,並將程式碼推送到倉庫中。
在這裡插入圖片描述
倉庫名隨便你叫什麼,然後將剛才的應用推送上去即可。
在這裡插入圖片描述

4,Gitee配置

推送完成後,回到Jenkins管理介面,我們來完成Gitee的配置,開啟系統配置。
在這裡插入圖片描述
找到Gitee配置,填入對應的資訊:
在這裡插入圖片描述
點選新增按鈕新增一個Jenkins憑證。
在這裡插入圖片描述
選擇Gitee API 令牌:
在這裡插入圖片描述
私人令牌的獲取地址為:https://gitee.com/profile/personal_access_tokens

在這裡插入圖片描述
在這裡插入圖片描述

在這裡插入圖片描述

5, 新建自動化部署任務

配置完成,接下來新建一個任務,點選新建Item。
在這裡插入圖片描述
隨便輸入一個任務名稱,並選擇【Freestyle project】。
在這裡插入圖片描述
在原始碼管理處勾選Git,並填入專案地址,然後在構建觸發器位置勾選觸發打包的時機。
在這裡插入圖片描述
在構建觸發器最底部位置點選生成Gitee WebHook密碼。
在這裡插入圖片描述

然後開啟Gitee專案中的WebHooks,新增webHook。
在這裡插入圖片描述
在這裡插入圖片描述

此處的URL需要填入一個公網IP,所以如果你是用的虛擬機器,就需要用內網穿透工具對映一下。

在這裡插入圖片描述
在這裡插入圖片描述
至於URL應該填什麼,我們需要修改一下。
在這裡插入圖片描述
填寫完成後點選新增,Gitee便會傳送一個Post請求到Jenkins,如果請求結果如下所示,則配置成功了。
在這裡插入圖片描述
重新回到Jenkins管理介面,繼續勾選構建觸發器下的輪詢SCM,輸入輪詢頻率。
在這裡插入圖片描述
最後在構建位置下增加構建步驟,選擇執行shell。
在這裡插入圖片描述
shell指令碼程式碼如下。

#!/bin/bash -il
docker rm -f app_docker
sleep 1
docker rmi -f app_docker:1.0
sleep 1
mvn clean install -Dmaven.test.skip=true
sleep 1
docker build -t app_docker:1.0 -f ./src/main/docker/Dockerfile .
sleep 1
docker run -d -p 8000:8000 --name app_docker app_docker:1.0

該指令碼表示刪除正在執行的app_docker容器,並刪除app_docker:1.0映象,然後使用mvn命令打包從Gitee拉取來的專案程式碼,接著使用專案中的Dockerfile檔案構建出一個映象,名稱為app_docker:1.0,最後執行該映象。

6,打包測試

最後點選儲存,部署任務就建立完成了,我們來測試一下有沒有問題。
在這裡插入圖片描述
點選立即構建,Jenkins會立馬進行一次構建,檢視控制檯輸出。
在這裡插入圖片描述
最後,我們開啟預設的地址即可。

相關文章