Git webhook 如何驅動 Jenkins 的參數化建置 (Build with Parameters)

之前文章 Jenkins 2 將其他 job 名稱變成可選擇的參數、Jenkins 2 如何建立 Pipeline job 曾經簡單地介紹過模組化 build flow 的想法，透過參數化建置 (Build with Parameters) 達成使用相同 job 執行不同 project 的建置

但這樣的做法在設定 webhook 執行 Continuous integration - CI build 時需要額外在 Git Server 的 Repository 上動些手腳，就來看看該如何設定

Jenkins Job 基本設定

有個名為 JobName 的 String Parameter
記得設定 Source Code Management
Build Triggers 有 Trigger builds remotely (e.g., from scripts)
簡單的印出上述參數

Jenkins 2 上的 webhook 設定

這邊就不重複贅述，請大家直接參考之前文章遠端 Git Repository 有 merge 時自動通知 Jenkins 2 進行編譯建置 (webhook)

需要留意的是 Jenkins 上關於 webhook 的說明

Use the following URL to trigger build remotely: JENKINS_URL/job/A01-TestDev/build?token=TOKEN_NAME or /buildWithParameters?token=TOKEN_NAME
Optionally append &cause=Cause+Text to provide text that will be included in the recorded build cause.

Git Server 的 webhook 設定

今天會使用 gitlab 做為範例

Git Repository –> Setting –> Integrations

URL

pattern

http://{jenkins_Url}/job/{job_name}/buildWithParameters?token={token}&{ParameterName}={ParameterValue}

範例

http://127.0.0.1/job/A02-TestQA/buildWithParameters?token=39296d67-6750-45ab&JobName=fromGitLab

如果執行 webhook 時有 Jenkins 權限上問題請試試使用 API TOKEN
- Jenkins People –> User Id
- Configure –> API Token
- 用法
```
http://{user_id}:{token}@{jenkins_Url}/job/{job_name}/buildWithParameters?token={token}&{ParameterName}={ParameterValue}
```
實測下 URL 中的 token 如果太長無法正確執行