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

更新时间:
复制 MD 格式

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

Jenkins插件安装

插件管理

单击系统管理,接着点击插件管理

Git 源码管理

可选插件中输入“Git plugin”找到代码源管理的插件并安装。

WebHook插件

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

安装后需重启Jenkins。

Jenkins 代码源配置

步骤一:新建 Jenkins 任务

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

步骤二:进入任务配置页面

Jenkins任务页面左侧导航栏中,单击配置进入任务配置页面。选择源码管理 > Git

Repository URL中填入Codeup仓库的HTTPS克隆地址,Branches to build中指定目标分支(默认为*/master)。

步骤三:源码管理配置

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

此时需要填写认证信息:

此时页面可能显示红色的认证错误提示,表示需要配置凭据。选择Credentials,如果没有,需要新建:

在弹出的添加凭据对话框中,类型选择Username with password范围选择全局,填写相应字段后单击添加

这里需要填写的用户名和密码,即Codeup代码仓库的克隆用户名和密码。获取方式如下:

Codeup代码库页面,单击右上角克隆/下载按钮,选择HTTPS标签页,单击立即查看链接即可获取克隆用户名和密码。

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

步骤四:配置触发器

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

选择Generic Webhook Trigger

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

参数说明:

Codeup Push事件为例,push webhook请求body如下。

如上在Variable中填ref,表示获取post请求bodyref字段,Expression中填$.ref表示获取bodyrefvalue值。

{
  "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": "gi*@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"
}

步骤五:配置Token

Token区域输入Token值。

这里Token项可选,支持用户自定义,用于接收方验证请求合法性,需要在CodeupWebhook里按照以下格式设置触发的 URL :http://jenkins地址/generic-webhook-trigger/invoke?token=(上述生成的token)

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

步骤六:配置构建脚本

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

步骤七:保存

保存设置:

单击页面底部的保存按钮。

Codeup侧配置Webhook

步骤一:配置webhook

进入目标代码库,选择设置 > Webhooks,进行新建webhook:

在页面右上角单击新建Webhook按钮。

步骤二:创建Webhook

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

URL设置:http://jenkins地址/generic-webhook-trigger/invoke?token=(上方步骤五中设置的 token值:XXXXXXX)

触发时机中,勾选需要触发构建的事件类型(如推送事件),然后单击确定完成Webhook创建。

重要

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