在我之前的工作工程中揣非, 每次感覺頭大的都是新項目的部署, 這個過程中就會涉及到Jenkins Job的創(chuàng)建躲因。 在文章運維平臺化一定是你的追求嗎早敬?中我們有提到Jenkins是實現(xiàn)Gitops的重要組成部分忌傻, 他是要干很多活的。 基于這樣的情況我們就要對Jenkins job相關(guān)的東西首先代碼化搞监。
PS: 本文所有東西使用Jenkins Pipeline實現(xiàn)水孩, 如果沒有相關(guān)基礎(chǔ)請先學(xué)習(xí)了解
第一步 - 安裝Job DSL插件
我們使用Jenkins Job DSL來實現(xiàn)job的管理, Jenkins Job DSL 支持使用 Groovy 代碼以編程方式創(chuàng)建 Jenkins Job琐驴。 我們需要將代碼存儲到git倉庫中俘种,從而使更改可追溯并自動完成 Jenkins Job的創(chuàng)建。
https://jenkinsci.github.io/job-dsl-plugin/
首先绝淡,瀏覽器輸入your_jenkins_url/pluginManager/available
. 在搜索框中安疗,輸入Job DSL
。接下來够委,在生成的插件列表中荐类,選中Job DSL旁邊的框,然后單擊Install without restart茁帽。
注意:如果搜索Job DSL
沒有返回結(jié)果玉罐,則表示已經(jīng)安裝了 Job DSL 插件,或者您的 Jenkins 服務(wù)器的插件列表未更新潘拨。您可以通過瀏覽器訪問your_jenkins_url/pluginManager/installed
并搜索Job DSL
.還可以訪問your_jenkins_url/pluginManager/available
并單擊插件列表底部的“check now”按鈕來更新 Jenkins 服務(wù)器的插件列表吊输。
啟動安裝以后,我們會進入安裝進度的頁面铁追,當(dāng)看到Job DSL和Loading plugin extensions旁邊看到“success”季蚂,然后再繼續(xù)下一步。
安裝完成job dsl插件后琅束, 我們就可以使用job DSL將配置代碼化扭屁。
第二部 - 創(chuàng)建seed job
要創(chuàng)建seed job, 訪問you_jenkins_url并且登陸以后涩禀, 點擊左側(cè)的New Item
選項料滥。 會出現(xiàn)如下圖所示的頁面,輸入job名稱艾船,并選擇類型為Freestyle project
, 點擊OK
保存
保存成功后進入job配置頁面葵腹, 向下滾動到Source Code Management
部分, 點擊選擇git, 在文本框內(nèi)輸入git地址以及選擇對應(yīng)的deloy key, 輸入文件的分支
Repository URL: git@git.example.com:devops/jenkins-job-dsl.git
Credentials: Deploy Key For Gitlab
Branches to build: master
注意: Deploy Key 最好使用單獨的key屿岂, 并且只分配可以clone代碼的權(quán)限践宴。
保存成功后進入job配置頁面, 向下滾動到Build部分爷怀,并單擊Add Build
步驟下拉菜單阻肩。接下來選擇Process Job DSLs
。
然后霉撵,單擊Use the provided DSL
腳本旁邊的單選按鈕磺浙,并將編寫的Job DSL
腳本路徑粘貼到DSL script
文本區(qū)域洪囤。
文本內(nèi)容為
jenkins-job-dsl/jobs/*.groovy
jenkins-job-dsl/jobs/demo/*/*.groovy
jenkins-job-dsl/jobs/example/*/*.groovy```
## 第三部 - Running Seed job
點擊剛創(chuàng)建好的job, 進行構(gòu)建
## 第四部 - 配置gitlab webhook
1) `Settings` > `Webhooks` > `Add webhook`
2) URL - https://jenkins.example.com/project/prod-yunwei-jenkins-seed-all
3) Triggers - Whatever you want them to be (most likely at least **push**)
**注意:** 需要gitlab當(dāng)前項目的master權(quán)限
## 第五部 - 維護git倉庫
首先在git中創(chuàng)建好`jenkins-job-dsl`名稱的倉庫撕氧, 按照如下的目錄維護好倉庫基礎(chǔ)內(nèi)容
http://git.example.com/devops/jenkins-job-dsl.git
**倉庫目錄結(jié)構(gòu)**
$ tree -L 3
.
├── CONTRIBUTING.md
├── README.md
├── jobs
│ ├── example # 維護業(yè)務(wù)相關(guān)的job目錄
│ │ ├── java # 維護java程序相關(guān)的job目錄
│ │ ├── mobile # 維護app程序相關(guān)的job瘤缩, 包括安卓和ios
│ │ ├── node # 維護前端相關(guān)的job
│ │ └── php # 維護php相關(guān)的job
│ ├── devops # 維護運維相關(guān)的job
│ │ ├── argocd_app.groovy
│ │ ├── docker_image
│ │ ├── dockerhub_to_aliyun.groovy
│ │ ├── kube_core_prod.groovy
│ │ ├── mother_imager_build.groovy
│ │ └── terraform_prod.groovy
│ ├── dashboard.groovy #維護jenkins view的腳本
│ ├── folders.groovy #維護全局目錄的腳本
│ └── seed_all.groovy #seed job的入口文件
└── scripts # 維護其它需要的groovy腳本
├── argocd.groovy
├── dockerhub-to-aliyun.groovy
├── image_build.groovy
└── mother_image_build.groovy
14 directories, 14 files
### Example: 添加一個java程序
編輯/jobs/java/config_prod.json`文件, 按照下面的格式添加項目
{
"PLEASE_READ": "Always add the following properties: 'name', 'owner', and 'description' for your multi-branch pipeline. Keep objects sorted by 'name'. Contact @devops in Slack with any questions.",
"pipelines": [
{
"name": "yunwei-demo",
"repository": "git@git.example.com:middle/yunwei-demo.git",
"git_address": "git@git.example.com",
"git_group": "middle",
"git_project": "yunwei-demo",
"module": "",
"job_folder": "match",
"env" : "pre",
"branch": "pre",
"language": "java",
"jenkinsfile_path": "Jenkinsfile",
"clone_option_timeout": 30,
"owner": "match"
}
]
}
編輯完成后push到gitlab伦泥,會觸發(fā)`seed job`的構(gòu)建