文章参考自:https://git-scm.com/book/zh/v2/%E8%87%AA%E5%AE%9A%E4%B9%89-Git-Git-%E9%92%A9%E5%AD%90
自定义Git – Git钩子
Git能在特定的重要动作发生时触发自定义脚本.
客户端钩子:由诸如提交和合并这样的操作所调用。
服务器钩子:诸如接收被推送的提交这样的联网操作。
安装一个钩子:
1,钩子都被存储在Git目录下的hooks子目录中。(.git/hooks)
2,把一个正确命名且可执行的文件放入 Git 目录下的 hooks 子目录中,即可激活该钩子脚本。
3,启用钩子脚本需要移除.sample后缀。
客户端钩子:
1,钩子类型
提交工作流钩子,
电子邮件工作流钩子,
其他钩子
2,提交工作流钩子
pre-commit钩子:
1,在键入提交信息前运行,检查即将提交的快照。
2,如果该钩子以非零值退出,git将放弃此次提交。不过可以用git commit --no-verify来提交.
3,这个钩子可以检查代码风格是否一致,尾随空白字符是否存在,或新方法的文档是否适当。
prepare-commit-msg钩子:
1,在启动提交信息编辑器之前,默认信息被创建之后运行。
2,允许编辑提交者所看到的编辑信息、
3,该钩子接收的写选项:存有当前提交信息的文件的路径,提交类型和修补提交的提交的SHA-1校验
4,适用于那些自动产生默认信息的提交,如提交信息模板,合并提交,压缩提交和修订提交等。
5,用来动态插入提交信息。
commit-msg钩子:
1,接收一个参数:存有当前提交信息的临时文件的路径。
2,如果该钩子脚本以非零值退出,Git将放弃提交。
3,用来在提交通过前验证项目状态或提交信息。
post-commit钩子:
1,在提交完成后运行,不接受任何参数。
2,该钩子一般用来通知之类的事情。
3,电子邮件工作流钩子
4,其他客户端钩子
pre-rebase钩子:
1,用于变基之前,以非零值退出可以终止变基的过程。
2,用于禁止对已经推送的提交变基。
post-rewrite钩子:
1,用于被那些会替换提交记录的命令调用。 --git commit --amend, git rebase
2,参数:触发重写的命令名。从标准输入中接受一系列重写的提交记录。
post-checkout钩子:
1,在git checkout成功运行后被调用。
2,用于调整工作目录,如放入大的二进制文件,自动生成文档或进行其他类似操作。
post-merge钩子:
1,在git merge成功运行后被调用。
2,用于恢复Git无法跟踪的工作区数据,比如权限数据。
3,用于验证某些在Git控制之外的文件是否存在。
pre-push钩子:
1,在git push运行期间,更新了远程引用但是尚未传送对象时被调用。
2,参数:远程分支的名字和位置。从标准输入中读取一系列更新的引用。
3,用于在推送开始之前,用它验证对引用的更新操作,(一个非零的退出码将终止推送过程)
pre-auto-gc钩子:
1,在垃圾回收之前被调用,用来提醒你现在要回收垃圾了,或者依情形判断是否要中断回收。
服务器端钩子:
1,对项目强制执行各种类型的策略。
2,这些钩子在推送到服务器之前和之后运行。
3,推送到服务器前运行的钩子可以在任何时候以非零值退出,拒绝推送并给客户端返回错误消息。
pre-receive钩子:
1,处理来自客户端的推送操作时,最先被调用的脚本是pre-receive.
2,从标准输入获取一系列被推送的引用。
3,如果该脚本以非零值退出,所有的推送内容都不会被接收。
4,该钩子用于阻止对引用进行非快进的更新,或者对该推送所修改的所有引用和文件进行访问控制。
update钩子:
1,update脚本与pre-receive脚本非常类似,不同之处在于它会为每一个准备更新的分支各运行一次。而pre-receive只会运行一次。
2,参数:引用的名字(分支),推送前的引用指向的内容的SHA-1值,以及用户准备推送的内容的SHA-1值。
3,如果update脚本以非零值退出,只有相应的那个引用会被拒绝,其余的依然会被更新。
post-receive钩子:
1,post-receive 挂钩在整个过程完结以后运行,可以用来更新其他系统服务或者通知用户。
2,接收与pre-receive相同的标准输入数据。
自定义Git - 使用强制策略的一个例子
1,Git工作流程
检查提交信息的格式,并且指定只能由特定用户修改项目中特定的子目录。