如何给一个github代码仓库配置一个push 的webhook,自动促发jenkins job

为 GitHub 仓库配置 Push Webhook 以自动触发 Jenkins Job,核心思路是让 GitHub 在收到代码推送时,主动通知 Jenkins 的 Webhook 接口,从而触发构建。

整个过程主要分为三步:Jenkins 端配置、GitHub 端配置 Webhook,以及网络与安全设置

1. 在 Jenkins 端:安装插件并配置 Job

第一步:安装必要插件
确保你的 Jenkins 已安装 GitHub Plugin。你可以在 Manage Jenkins > Manage Plugins 的 "Available" 标签页中找到并安装它。这个插件是 Jenkins 与 GitHub 集成、接收 Webhook 通知的基础

第二步:配置 Job 的构建触发器

  1. 进入你需要自动触发的 Jenkins Job 的配置页面。

  2. 在 "Build Triggers"(构建触发器)部分,勾选 "GitHub hook trigger for GITScm polling"(旧版可能显示为 "Build when a change is pushed to GitHub")

  3. 同时,在 "Source Code Management"(源码管理)部分,确保已正确配置 Git 仓库地址和分支,以便 Jenkins 知道去拉取哪个仓库的代码

如果想给所有分支都配置webhook就在指定分支:保持空,或者写:**

image

 

2. 在 GitHub 端:添加 Webhook

第一步:获取 Jenkins Webhook URL
Jenkins 接收 Webhook 的通用地址格式如下:
http://<你的Jenkins地址>/github-webhook/
例如:https://ci.example.com/jenkins/github-webhook/

第二步:在 GitHub 仓库中配置

  1. 进入你的 GitHub 仓库页面,点击 Settings(设置)标签页。

  2. 在左侧边栏中,点击 Webhooks

  3. 点击 Add webhook(添加 Webhook)按钮

  4. 在表单中填写关键信息:

    • Payload URL:填入第一步中获取的 Jenkins Webhook URL

    • Content type:选择 application/json

    • Secret:可选,但强烈建议设置。这是一个用于验证请求来源的密钥,你需要记录下这个密钥,以便在 Jenkins 端进行验证配置,增强安全性

    • Which events would you like to trigger this webhook?:选择 "Just the push event",这样只有代码推送才会触发构建

    • 确保 Active 复选框被勾选,然后点击 "Add webhook" 保存

posted @ 2026-08-20 14:55  苹果芒  阅读(3)  评论(0)    收藏  举报