gitlab服务器端hook最全详解

1.hook是什么?

GitLab hook 可用于拦截特定事件（如 push 代码），以便实现功能扩展。

主要有两类hook：

• web hooks

• customer hooks

其中customer hooks具有客户端和服务器端配置，现在主要讲一下服务器端hook配置

2.服务器端的hook怎么配置

往GitLab服务器push提交点，会按顺序先后执行服务器上的pre-receive、update和post-receive三种类型的钩子脚本。

2.1 单仓库钩子（两种方法）

方法一：

找到仓库所在目录。（14.0版本以后只能靠gitlab服务器管理员寻找hash存储路径）

在仓库 xxx.git 目录下创建 custom_hooks 子目录。

在 custom_hooks 目录中创建脚本文件（如pre-receive）。

确保脚本文件具有可执行权限，并且属主为Git用户。

编写脚本内容，脚本支持很多语言，包括但不限于shell、ruby等脚本。

方法二：（个人推荐这个，比较容易直观看出脚本简洁信息）

找到仓库所在目录。

在仓库 xxx.git 的custom_hooks 下建这三个目录pre-receive.d update.d post-receive.d

在pre-receive.d下创建脚本文件如：1_commit_message.sh

2.2 多仓库钩子（以pre-receive为例）

注意：对gitlab服务器上所有的项目起作用

第一步，找到要配置仓库在 gitlab 中存储的路径，但因 gitlab 的仓库自某个版本开始采用 hash 存储，我们想要知道仓库对应的物理路径，可以通过管理员账号拿到对应的物理路径

第二步，进入路径下新建目录 custom_hooks/pre-receive.d，进入目录后再创建脚本文件 （推送前），同时修改 脚本文件的权限。

chmod +777 xxxx.sh

第三步，在本地尝试推送，推送显示如下，如果不符合规范则无法提交成功。

PS:

对于全局的hook，配置脚本后gitlab系统上所有仓库都受影响，开关在配置文件gitlab.rb中（默认安装路径/etc/gitlab/gitlab.rb），找到下面这条

#gitaly['custom_hooks_dir'] = "/var/opt/gitlab/gitaly/custom_hooks"

去掉注释，配置自己的hook脚本存放路径。