寻求与Git post-receive功能类似的Gerrit钩子：每次推送仅触发一次

嘿，我太懂你这种“明明应该一次搞定却反复触发”的烦躁了！之前我也在Gerrit钩子上踩过这个坑——用ref-update或ref-updated时，推多个提交就会收到一堆重复通知，完全不符合我们要的“一次推送一次通知”的需求。

其实答案真的就在眼前：Gerrit本身就提供了类似Git post-receive的钩子，它会在整个推送操作完成后仅触发一次，不管你这次推送包含多少个提交或引用更新。下面是具体的实现步骤：

1. 找到Gerrit的钩子目录 #

默认情况下，Gerrit的服务器端钩子存储在$GERRIT_SITE/hooks目录下（$GERRIT_SITE是你的Gerrit安装根目录，比如/var/gerrit）。如果这个目录下没有post-receive文件，直接新建一个即可。

2. 编写post-receive钩子脚本 #

这个脚本会在整个推送完成后执行，你可以在里面收集推送信息并发送通知。下面是一个bash示例：

#!/bin/bash

# 临时存储推送的引用信息
UPDATED_REFS=""

# 读取Git推送的标准输入（每行格式：旧提交SHA 新提交SHA 引用名）
while read OLD_SHA NEW_SHA REF_NAME; do
    UPDATED_REFS+="更新引用: ${REF_NAME} (${OLD_SHA:0:7} → ${NEW_SHA:0:7})\n"
done

# 构建通知内容，这里可以替换成你需要的通知方式（邮件、企业微信、Slack等）
NOTIFY_CONTENT="用户 ${GERRIT_USER_NAME} 完成了一次推送操作！
项目: ${GERRIT_PROJECT}
更新的引用列表：
${UPDATED_REFS}"

# 示例：发送邮件通知
echo -e "${NOTIFY_CONTENT}" | mail -s "Gerrit推送通知" team-alerts@yourcompany.com

# 如果你用其他通知工具，比如curl调用企业微信API：
# curl -X POST -H "Content-Type: application/json" -d '{"msgtype":"text","text":{"content":"'"${NOTIFY_CONTENT}"'"}}' https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your-webhook-key

3. 给钩子脚本添加执行权限 #

在Gerrit服务器上运行命令：

chmod +x $GERRIT_SITE/hooks/post-receive

关键说明：为什么之前的钩子会多次触发？ #

• ref-update和ref-updated是针对单个引用更新触发的：如果你的推送包含多个引用（比如同时推多个分支），或者你推送的是多个Gerrit变更（每个变更对应一个refs/changes/xx/xxx/xx格式的临时引用），这两个钩子就会为每个引用各触发一次。
• 而post-receive是针对整个Git推送会话触发的：不管这次推送里有多少个引用更新，它只会在所有操作完成后执行一次，完美匹配你要的“一次推送一次通知”需求。

测试验证 #

推多个提交或多个分支到Gerrit，检查你的通知渠道（邮件、即时通讯工具），应该只会收到一条汇总通知，而不是每条提交/引用各一条。

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