Jenkins通过Gogs Webhook获取Payload问题咨询

我之前也碰到过一模一样的需求——用一个通用Jenkins任务处理多仓库的Docker构建，通过Gogs Webhook触发，当时用Gogs插件确实踩了点小坑，下面给你两种实用的解决方案：

方案一：利用Gogs Jenkins插件自带的环境变量 #

Gogs插件其实会自动把Payload里的核心字段转换成Jenkins环境变量，根本不用手动解析整个JSON。你可以先在任务里加一个Execute shell步骤，执行这条命令打印所有Gogs相关的环境变量：

printenv | grep GOGS

常见的可用变量包括：

• ${GOGS_REPO_NAME}：仓库名称
• ${GOGS_REPO_URL}：仓库的Git地址
• ${GOGS_BRANCH}：触发Webhook的分支（比如main或dev）
• ${GOGS_COMMIT}：提交的哈希值
• ${GOGS_COMMIT_MESSAGE}：提交信息

这些变量可以直接在你的Docker构建脚本里用，比如根据仓库名生成镜像标签：

docker build -t ${GOGS_REPO_NAME}:${GOGS_BRANCH} .

方案二：用Generic Webhook Trigger插件获取完整Payload #

如果Gogs插件提供的变量不够用（比如需要Payload里的自定义字段、提交者详情等），推荐用Generic Webhook Trigger插件，它能灵活解析任意JSON格式的Webhook Payload：

1. 安装插件后，进入你的Jenkins任务配置，在构建触发器里勾选"Generic Webhook Trigger"
2. 配置参数提取：
   • 在"Post content parameters"区域点击"Add"，添加你需要的参数：
     • 提取仓库名：Key填repo_name，JSON Path填$.repository.name
     • 提取分支名：Key填branch，JSON Path填$.ref.split('/')[2]（因为Gogs的ref字段格式是refs/heads/main，拆分后取第三段就是分支名）
     • 如果要拿到完整Payload，可以加一个Key为full_payload，JSON Path填$
3. 去Gogs仓库的Webhook设置里，把Payload URL改成http://你的Jenkins地址/generic-webhook-trigger/invoke，Content Type选application/json
4. 配置完之后，你就能在任务里通过${repo_name}、${branch}、${full_payload}这些自定义变量获取Payload内容了

调试小技巧 #

要是不确定Payload的结构，可以在Jenkins任务里加个步骤打印完整内容：

• 用Generic插件的话，直接执行：

echo ${full_payload} > payload.json
cat payload.json

• 构建完成后，在控制台输出里就能看到完整的Payload结构，方便你调整JSON Path提取需要的字段

内容的提问来源于stack exchange，提问作者Guillaume LUNIK