GitLab服务如何高效集成Hooks.pdf

GitLab
Server
Hooks

版本编号
变更描述
创建⽇期
创建⼈

1.0.0
初始版本
2022年11⽉4号
刘启浩

Git
代码合并出现的问题

本地解决合并冲突

1.执⾏
git
pull
或
git
merge
时产⽣冲突，在本地IDE解决代码冲突时，因冲突较多、冲突代码难以取

舍、冲突代码范⼤等原因，容易造成代码覆盖、代码丢失等问题

错误合并分⽀

1.在
feature
功能分⽀进⾏需求开发时，错误将
dev/test
分⽀合并到
feature
分⽀，导致
feature
分

⽀被污染

处理⽅案

本地解决合并冲突问题

1.本地合并代码时对不确定的部分与相应的开发⼈员确认

2.提交
MR
时对修改代码的上下⽂语义进⾏审查

错误合并分⽀问题

1.开发约束，分⽀合并限制，限制
dev/test
分⽀合并⾄其它分⽀

2.系统约束，在
GitLab
侧使⽤
Server-Side
Hooks
:
pre-receive，添加执⾏脚本：在执⾏
git
push

时，获取本次
push
中的
git
信息，判断是否存在
dev/test
向当前分⽀（⾃⾝除外）合并的嫌疑，

如果有
则进⾏阻断给出提⽰，否则给出⾃查提⽰、正常推送。

a.GitLab参考链接：/15.4/ee/administration/server_hooks.html

b.Git参考链接/book/en/v2/Customizing-Git-Git-Hooks

3.实现⽅式

a.获取
git
push
的当前commit、基准commit、分⽀信息

b.获取基准commit
-
当前commit
所有commit消息，对消息做关键字匹配，例如存在（Merge

branch
featureinto
master）此类merge消息，如果匹配dev/test向其它分⽀合

并则阻断，否则给出⾃查提⽰

Merge-From-dev阻断.mp4

Post-Merge添加代码阻断.mp4

4.特殊场景

a.Git
fast-forward模式下，merge
操作不会产⽣commit记录，mege
过来的其它commit记录可

能不存在merge
commit，例如将dev
merge
到
feature
分⽀10条commit、触发了fast-

forward、此时没有当前merge的commit记录、merge过来的10条commit也不存在merge

commit记录，此场景下脚本⽆法匹配

b.merge
操作产⽣commit记录，使⽤
git
rebase
命令，将分⽀重整，merge
操作产⽣的commit

记录会被清理，此场景下脚本⽆法匹配

c.merge
操作产⽣commit记录，主动修改commit消息，此场景下脚本⽆法匹配

Merge-Update-Commit.mp4

Post-Merge-Rebase.mp4

Post-Merge-Update-commit.mp4

Git
fast-forward
模式

Merge-fast-forward.mp4

Merge-no-ff.mp4

脚本部署

脚本

pre-receive

2.83KB

Docker环境部署

1.在容器/var/opt/gitlab/gitaly
⽬录（如果此⽬录再宿主机有映射，则在宿主机映射⽬

录），创建
ustom_hooks/pre-reeive.d
⽬录，将脚本放在此⽬录下，赋予执⾏权限

1#若⽬录⽆映射

2##容器内执⾏创建⽬录

3mkdir-pv/var/opt/gitlab/gitaly/ustom_hooks/pre-reeive.d

4##容器外执⾏复制脚本到指定⽬录

5dokerppre-reeive.sh[容器ID]:/var/opt/gitlab/gitaly/ustom_hooks/pre-reeive

6##容器内执⾏赋予脚本权限

7hmod+xp