本文介绍如何使用 Codeup 代码库关联 Jenkins 进行持续集成。主要涉及内容包括关联代码源、配置触发器的过程。
Jenkins插件安装
插件管理
点击①处「系统管理」,接着点击②处「插件管理」:
Git 源码管理
在③处「可选插件」中输入“Git plugin”找到代码源管理的插件并安装:
WebHook 插件
同理,在可选插件中搜索 “Generic Webhook Trigger Plugin”,并安装。
安装后需重启Jenkins。
Jenkins 代码源配置
Step1:新建 Jenkins 任务
首先,新建期望的 Jenkins 任务,然后准备配置代码源。
Step2:进入任务配置页面
选择源码管理-Git:
Step3:源码管理配置
选择Git,填入Codeup仓库地址,例如:https://codeup.aliyun.com/xxxx/Codeup-Demo.git
此时需要填写认证信息:
选择Credentials,如果没有,需要新建:
这里需要填写的用户名和密码,就是Codeup代码仓库的克隆用户名和密码。获取位置如下图所示:
配置完成后如页面不再报错,则鉴权通过。
Step4:配置触发器
继续在设置页中找到「构建触发器」:
选择「Generic Webhook Trigger」:
配置获取 Codeup Webhook 的请求参数:
参数说明:
以 Codeup Push 事件为例,push webhook 请求 body 如下。
如上在 Variable 中填 ref,表示获取 post 请求 body 中 ref 字段,Expression 中填 $.ref 表示获取 body 中 ref 的 value 值。
{
"after": "f9e10a78d6ddd897e522aac418c60c742250cxxx",
"before": "b509e74e75a56026b6650c7d902474d1eaa7bxxx",
"checkout_sha": "f9e10a78d6ddd897e522aac418c60c742250cxxx",
"commits": [
{
"author": {
"email": "test@example.net",
"name": "test"
},
"id": "f9e10a78d6ddd897e522aac418c60c742250cxxx",
"message": "init\n",
"timestamp": "2021-08-31T18:03:33.000Z",
"url": "https://codeup.aliyun.com/612a21eaadb2703b38cd6xxx/Codeup-Demo/commit/f9e10a78d6ddd897e522aac418c60c742250cxxx"
}
],
"object_kind": "push",
"project_id": 1179553,
"ref": "refs/heads/master",
"repository": {
"description": "进入示例代码库快速了解云效 Codeup 功能",
"git_http_url": "https://codeup.aliyun.com/612a21eaadb2703b38cd6xxx/Codeup-Demo.git",
"git_ssh_url": "git@codeup.aliyun.com:612a21eaadb2703b38cd6xxx/Codeup-Demo.git",
"homepage": "https://codeup.aliyun.com/612a21eaadb2703b38cd6xxx/Codeup-Demo",
"name": "Codeup-Demo",
"url": "git@codeup.aliyun.com:612a21eaadb2703b38cd6xxx/Codeup-Demo.git",
"visibility_level": 10
},
"total_commits_count": 1,
"user_email": "test@example.net",
"user_extern_uid": "5f969843cd2214ba0e243xxx",
"user_id": 96867,
"user_name": "test"
}
Step5:配置 Token 值
这里 Token 项可选,支持用户自定义,用于接收方验证请求合法性,需要在 Codeup 的 Webhook 里按照以下格式设置触发的 URL :
http://jenkins地址/generic-webhook-trigger/invoke?token=(上述生成的token)
如果此处不使用 Token 的形式,触发的 URL 需要如下格式设置 ,否则无法验证身份:http://user:passsword@jenkins/generic-webhook...
Step6:配置构建脚本
根据你的持续集成需求,配置对应 Jenkins 脚本。
Step7:保存
Codeup 侧配置 Webhook
Step1:配置 webhook
进入库设置-Webhooks:
Step2:创建 Webhook
填入上方 Jenkins 提供的 Hook URL + 自定义的 Token。
URL设置:
http://jenkins地址/generic-webhook-trigger/invoke?token=(上面 Step5 中设置的 token值:XXXXXXX)
注意:此方式暂不支持 Secret Token 字段。