文档

如何关联Jenkins进行持续集成?

更新时间:

本文介绍如何使用 Codeup 代码库关联 Jenkins 进行持续集成。主要涉及内容包括关联代码源、配置触发器的过程。

Jenkins插件安装

插件管理

点击①处「系统管理」,接着点击②处「插件管理」:

1

Git 源码管理

在③处「可选插件」中输入“Git plugin”找到代码源管理的插件并安装:

1

WebHook 插件

同理,在可选插件中搜索 “Generic Webhook Trigger Plugin”,并安装。

3

安装后需重启Jenkins。

Jenkins 代码源配置

Step1:新建 Jenkins 任务

首先,新建期望的 Jenkins 任务,然后准备配置代码源。

Step2:进入任务配置页面

4选择源码管理-Git:

5

Step3:源码管理配置

选择Git,填入Codeup仓库地址,例如:https://codeup.aliyun.com/xxxx/Codeup-Demo.git

此时需要填写认证信息:

6选择Credentials,如果没有,需要新建:

7

这里需要填写的用户名和密码,就是Codeup代码仓库的克隆用户名和密码。获取位置如下图所示:

8

配置完成后如页面不再报错,则鉴权通过。

Step4:配置触发器

继续在设置页中找到「构建触发器」:

7选择「Generic Webhook Trigger」:

7

配置获取 Codeup Webhook 的请求参数:

8

参数说明:

以 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 值

8

这里 Token 项可选,支持用户自定义,用于接收方验证请求合法性,需要在 Codeup 的 Webhook 里按照以下格式设置触发的 URL :

http://jenkins地址/generic-webhook-trigger/invoke?token=(上述生成的token)

如果此处不使用 Token 的形式,触发的 URL 需要如下格式设置 ,否则无法验证身份:http://user:passsword@jenkins/generic-webhook...

Step6:配置构建脚本

根据你的持续集成需求,配置对应 Jenkins 脚本。

Step7:保存

0

Codeup 侧配置 Webhook

Step1:配置 webhook

进入库设置-Webhooks:

1

Step2:创建 Webhook

填入上方 Jenkins 提供的 Hook URL + 自定义的 Token。

URL设置:

http://jenkins地址/generic-webhook-trigger/invoke?token=(上面 Step5 中设置的 token值:XXXXXXX)

0

注意:此方式暂不支持 Secret Token 字段。