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

xiangzhihong發表於2022-03-01
JenkinsDockerGiteeSpring Boot

當我們使用傳統的開發方式開發後臺系統時，每寫完一個功能點就需要重新執行一下專案，然後進行測試，如果是專案比較小還可以，但是如果專案比較大的話，由於涉及的人員比較多，這種開發方式就比較麻煩。基於此，我們就需要使用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會立馬進行一次構建，檢視控制檯輸出。
在這裡插入圖片描述
最後，我們開啟預設的地址即可。

相關文章