在 GitLab 中配置 Webhook 来调用 Java 接口以校验 commit 信息，是很多公司的一些要求，因为提交信息的规范化是必要的
原理
GitLab中的拦截钩子（Interceptor Hook）是一个自定义的钩子（Hook），用于拦截和修改Git命令的输出。它的工作原理是在Git命令执行后，将命令的输出拦截下来，然后通过修改钩子脚本来对输出进行修改，最后再将修改后的输出返回给调用方。
拦截钩子的原理是利用了GitLab的Web Hooks机制。Web Hooks是一种通过HTTP POST发送通知的机制，它允许在特定事件（如代码提交、分支创建等）发生时触发自定义的脚本。通过在GitLab项目中配置Web Hook，可以指定在特定事件发生时执行的操作。
拦截钩子的配置步骤如下：
在GitLab项目中创建一个名为.gitlab-ci.yml的文件，并定义一个名为Interceptor的job。
在Interceptor job中，使用before_script或script指令定义拦截钩子的操作。这些操作可以包括对Git命令输出的处理、修改和其他自定义操作。
在Interceptor job中，使用output指令定义拦截钩子的输出格式和内容。输出格式可以是文本、JSON或其他格式，内容可以包含Git命令的原始输出、修改后的输出或其他自定义数据。
在Interceptor job中，使用only或except指令指定触发拦截钩子的特定事件。例如，可以指定在代码提交或分支创建时触发拦截钩子。
配置完成后，提交代码并触发特定事件，GitLab将会自动执行拦截钩子中的定义的操作，并将修改后的输出通过HTTP POST发送给调用方。
通过这种方式，GitLab中的拦截钩子可以实现自定义的Git命令输出拦截和修改功能，从而满足特定的需求，如对代码提交日志的格式转换、数据筛选等。
不阻止commit的版本
在 GitLab 项目中进入设置页面。
在左侧导航栏中选择 “Webhooks”（Web钩子）。
在 Webhooks 页面中点击 “Add Webhook”（添加 Webhook）按钮。
在 Webhook 配置表单中，填写以下信息：
- Name：自定义 Webhook 的名称。
- URL：调用 Java 接口的 URL。
- Push events：勾选 “Push events”（推送事件）选项，以便在每次 commit 时触发 - Webhook。
- Active：勾选 “Active”（激活）选项，使 Webhook 生效。
- Secret token：自定义一个 secret token，用于验证请求的合法性。
- 点击 “Add Webhook”（添加 Webhook）按钮，完成配置。
接下来，需要编写 Java 接口来接收并校验 commit 信息。以下是一个简单的示例代码，可以根据实际需求进行修改和扩展：
import javax.servlet.http.HttpServletRequest; import org.json.JSONObject; import com.fasterxml.jackson.databind.ObjectMapper; @RestController public class CommitHookController { @Autowired private ObjectMapper objectMapper; @RequestMapping("/webhook") public String webhook(HttpServletRequest request) throws Exception { String body = request.getReader().readLine(); JSONObject json = new JSONObject(body); String ref = json.getString("ref"); String pusher = json.getString("pusher"); JSONObject commit = json.getJSONObject("commit"); String message = commit.getString("message"); // 在这里添加校验逻辑，例如检查 commit message 是否符合要求等。 if (!message.matches("[a-zA-Z0-9\\s]+")) { return "Invalid commit message."; } // 返回成功响应或其他自定义响应。 return "Commit hooks are awesome!"; } }
实战配置如下（阻止commit提交的配置）
阻止commit提交需要修改配置文件，暂时不支持可视化配置
登录到GitLab服务器。
导航到你的项目的存储库目录。
在该目录下创建一个名为hooks的文件夹（如果已存在，请跳过此步骤）。
进入hooks文件夹。
使用文本编辑器创建一个名为pre-receive的文件。
在pre-receive文件中编写你的钩子逻辑，例如调用Java接口进行commit信息校验。
保存并关闭文件。
具体配置
#!/bin/sh # 获取commit信息 commit_id=$1 commit_message=$(git show -s --format=%B $commit_id) # 调用Java接口进行校验 response=$(curl -s -X POST -H "Content-Type: application/json" -d "{\"commitId\": \"$commit_id\", \"commitMessage\": \"$commit_message\"}" http://example.com/api/validate) # 解析Java接口返回的结果 if echo $response | grep -q "error"; then echo "Commit validation failed: $response" exit 1 fi # 允许提交 exit 0
配置pre-receive钩子不需要重启GitLab。在GitLab的服务器上，只需要按照以下步骤操作：
在项目的存储库目录下创建一个名为“hooks”的文件夹。
进入“hooks”文件夹。
创建一个名为“pre-receive”的文件。
在“pre-receive”文件中编写钩子逻辑，例如调用Java接口进行commit信息校验。
保存并关闭文件。
这样就完成了pre-receive钩子的配置，它会在每次提交代码时被调用，其中的逻辑是检查commit信息是否符合要求，可以阻止不符合要求的提交。
问题
- git的webhook配置范围是单个项目还是gitlab上的所有项目
Git的Webhook配置范围可以针对单个项目，也可以针对GitLab上的所有项目。具体配置取决于你的需求。
对于单个项目，可以在项目的设置页面中找到Webhooks选项，然后进行配置。对于所有项目，可以在GitLab的全局设置中进行配置。
需要注意的是，Webhook的配置信息是存储在GitLab的数据库中的，所以在进行配置更改后，需要提交更改并推送到GitLab服务器上才能生效。
