當我們提交程式碼到GitHub後，可以在Jenkins上執行構建，但是每次都要動手去執行略顯麻煩，今天我們就來實戰Jenkins的自動構建功能，每次提交程式碼到GitHub後，Jenkins會進行自動構建；

前期準備工作

進行本章的實戰前，推薦您參照《docker下的Jenkins安裝和體驗》做安裝和體驗的實戰，以便對Jenkins服務有初步瞭解；

重要前提

1. GitHub收到提交的程式碼後要主動通知Jenkins，所以Jenkins所在伺服器一定要有外網IP，否則GitHub無法訪問，我的Jenkins伺服器是部署在騰訊雲的雲主機上，帶有外網IP；
2. 本次實戰要提交原始碼到GitHub，所以您需要有一個GitHub號，並在上面建立工程；

demo工程原始碼

本次用來在Jenkins上構建的工程是個springboot的web工程，地址是：[email protected]:zq2599/jenkinsdemo.git，用瀏覽器訪問的地址是：https://github.com/zq2599/jenkinsdemo.git；
程式碼很簡單，只有一個controller，接收http請求返回一個字串，如下所示：

@RestController
public classHello {
    @RequestMapping("/")
    public String sayHello(){
        return
 
 "3. Hello jenkins, " + new Date();
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7

您需要在自己的GitHub建立一個專案，原始碼可以參照上述demo工程的原始碼；

實戰步驟梳理

本次整個實戰過程依次為如下步驟：
1. GitHub上準備一個spring boot的web工程；
2. GitHub上配置Jenkins的webhook地址；
3. 在GitHub上建立一個access token，Jenkins做一些需要許可權的操作的時候就用這個access token去鑑權；
4. Jenkins安裝GitHub Plugin外掛；
5. Jenkins配置GitHub訪問許可權；
6. Jenkins上建立一個構建專案，對應的原始碼是步驟1中的web工程；
7. 修改web工程的原始碼，並提交到GitHub上；
8. 檢查Jenkins的構建專案是否被觸發自動構建，構建成功後，下載工程執行，看是不是基於最新的程式碼構建的；

webhook地址

webhook是通知Jenkins時的請求地址，用來填寫到GitHub上，這樣GitHub就能通過該地址通知到Jenkins；
假設Jenkins所在伺服器的地址是：192.168.0.1，埠為8080，那麼webhook地址就是

再次提醒，上述地址必須是外網也能訪問的，否則GitHub無法訪問到Jenkins；

配置GitHub

1. 登入GitHub，進入要本次構建用到的工程；
2. 在工程主頁面點選右上角的”Settings”，再點選左側”Webhooks”，然後點選“Add webhook”，如下圖：
   
3. 如下圖，在”Payload URL”位置填入webhook地址，再點選底部的”Add webhook按鈕”，這樣就完成webhook配置了，今後當前工程有程式碼提交，GitHub就會向此webhook地址發請求，通知Jenkins構建：
   

生成Personal access tokens

Jenkins訪問GitHub工程的時候，有的操作是需要授權的，所以我們要在GitHub上生成授權的token給Jenkins使用，這就是Personal access tokens，生成步驟如下：
1. 登入GitHub，進入”Settings”頁面，點選左下角的”Developer settings”，如下圖：

2. 跳轉到”Developer settings”頁面後，點選左下角的“Personal access tokens”，如下圖：

3. 跳轉到”Personal access tokens”頁面後，點選右上角的”Generate new token”按鈕，如下圖：

4. 可能會提示輸入GitHub密碼，輸入後跳轉到建立token的頁面，如下圖所示，輸入title，再勾選”repo”和”admin:repo_hook”，再點選底部的”Generate token”按鈕，就能產生一個新的access token，將此字串複製下來，後面jenkins任務中會用到：

Jenkins配置

1. GitHub Plugin外掛，在”系統管理->管理外掛”位置檢查此外掛是否已經安裝，沒有的話請先安裝；
2. 配置GitHub，點選“系統管理->系統設定”，如下圖：
   
3. 在系統設定頁面找到”GitHub”，配置一個”GitHub Server”，如下圖，”API URL”填寫”https://api.github.com“，”Credentials”位置如下圖紅框所示，選擇”Add->Jenkins”：
   
4. 彈出的頁面中，”Kind”選擇”Secret text”，”Secret”填入前面在GitHub上生成的Personal access tokens，Description隨便寫一些描述資訊，如下圖：
   
5. 填寫完畢後，點選右側的”Test connection”按鈕，如果資訊沒有填錯，顯示的內容如下圖所示：
   
6. 點選頁面最底部的”儲存”按鈕；

GitHub專案的專案主頁和倉庫地址

專案主頁和倉庫地址是不同的，如下圖，紅框1中是專案主頁，點選紅框2的按鈕後，紅框3中是倉庫地址（要用HTTPS的，不用SSH 的）：

新建構建專案

在Jenkins上新建一個maven構建專案，名為test003，如下圖：

接下來設定test003的配置資訊，分為”原始碼管理設定”和”構建環境設定”兩部分；

原始碼管理設定

上圖中每個紅框的設定如下解釋：
1. 選擇”Git”；
2. “Repository URL”輸入倉庫地址：https://github.com/zq2599/jenkinsdemo.git；
3. “Credentials”建立一個Credentials，Kind選擇”Username with password”，Username輸入GitHub賬號，Password輸入GitHub密碼；
4. “原始碼庫瀏覽器”選擇”githubweb”；
5. “URL”輸入專案主頁：https://github.com/zq2599/jenkinsdemo；
6. “構建觸發器”中勾選”GitHub hook trigger for GiTScm polling”；

構建環境設定

如下圖所示，勾選”Use secret text(s) or file(s)”，下面的”Credentials”選擇我們之前配置過的”Personal access tokens”

設定完成後，點選頁面底部的”儲存”按鈕；

修改web工程程式碼並提交到GitHub

將GitHub倉庫的程式碼clone到本地，做一些修改然後提交到GitHub上，例如我修改了Hello.java中的原始碼（修改了sayHello方法的return的字串的內容），如下所示：

@RestController
public classHello {

    @RequestMapping("/")
    public String sayHello(){
        //修改返回的字串的內容
        return "abcdefg. Hello jenkins, " + new Date();
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9

提交到GitHub的操作如下圖所示：

Jenkins自動構建

回到Jenkins的test003頁面，可以看到已經開始自動構建了，如下圖：

驗證自動構建結果

1. 在test003的頁面，點選”工作空間”->”工作區”，如下圖：
   
2. 點選下圖紅框中的”mavendockerplugindemo-0.0.1-SNAPSHOT.jar”，瀏覽器就會下載這個檔案：
   
3. 下載成功後，在mavendockerplugindemo-0.0.1-SNAPSHOT.jar所在目錄下執行命令java -jar mavendockerplugindemo-0.0.1-SNAPSHOT.jar，web應用啟動成功，如下圖：
   
4. 瀏覽器輸入localhost:8080，可以看到web應用返回的內容是我們剛剛提交的最新內容，如下圖：
   

至此，GitHub提交觸發Jenkins自動構建的實戰就完成了，希望能對您搭建持續構建環境有所幫助。