Git hooks与自动化部署

好的 commit message 是至关重要的，如果随意编写 log，带来的后果可小可大，但是无论大小都影响了开发的效率和回朔的难度，所以有必要进行 log 规范化检查。

通过自定义的commit message，我们可以

jenkins虽好，但是对于小型项目，特别是客户合作开发。一些自动化的东西就需要自己手工编写脚本了。如git 的hooks  nodejs 的shell.js，甚至打包工具， webpack执行终端shell命令操作系统：webpack-shell-plugin。最多用的还是git hooks

Git 钩子(hooks)

Git 钩子(hooks)是在 Git 仓库中特定事件(certain points)触发后被调用的脚本。通过钩子可以自定义 Git 内部的相关（如 git push）行为，在开发周期中的关键点触发自定义的行为。

Git 含有两种类型的钩子：客户端的和服务器端的。

• 客户端钩子由诸如提交和合并这样的操作所调用
• 服务器端钩子作用于诸如接收被推送的提交这样的联网操作。

Git 钩子最常见的使用场景包括根据仓库状态改变项目环境、接入持续集成工作流等。由于脚本是可以完全定制，所以你可以用 Git 钩子来自动化或者优化你开发工作流中任意部分。

Git 钩子安装

Git 钩子存在于每个 Git 仓库的 .git/hooks 目录中。 

当你用 git init 初始化一个新版本库时，Git 默认会在这个目录中放置一些示例脚本。所有的示例都是 shell 脚本，其中一些还混杂了 Perl 代码，不过，任何正确命名的可执行脚本都可以正常使用 —— 你可以用 Ruby 或 Python，或其它语言编写它们。

默认存在的都是示例，其名字都是以 .sample 结尾，如果你想启用它们，得先移除这个后缀。把一个正确命名且可执行的文件放入 Git 目录下的 hooks 子目录中，即可激活该钩子脚本。 这样一来，它就能被 Git 调用。

创建 post-commit 脚本

touch post-commit

然后在 post-commit 文件中写入以下内容

#!/usr/bin/env python# coding=utf-8## commit msg checkimport sysimport reimport ioif hasattr(sys.stdout, 'buffer'):
    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')TIPS_INFO = '''
不符合commit规范，提交失败（当前状态等于没做刚刚的commit操作）！

commit规范：
类型 详细消息

规范样例：
git commit -m "xxxxx xxxxxxxxxxxxx"

！！！！提交失败！！！！
'''def check_commit_line1_format(msg):
    regOther = r'\S{5,} (.){10,100}'
    matchObj = re.match(regOther, msg)
    return matchObjif __name__=="__main__":
    with open(sys.argv[1], 'r') as f:
        for line in f:
            if (check_commit_line1_format(line)):
                sys.exit(0)
            else:
                print(TIPS_INFO)
                sys.exit(1)

Git hooks 案例：commit msg 格式自动检查实战

虽然有很多现成的 hook 可用，上面给出例子就是演示下，这里实现一个提交 message 格式的简单检查，要求提交消息单行且分两部分，且有一定的字数限制（实际你可以任意 YY 规则）。

钩子如何编写，如何定义，官方文档写的非常详细：https://git-scm.com/book/zh/v2/自定义-Git-Git-钩子

Git 钩子的作用域

Git 钩子是对本地仓库相关操作影响，对于任何 Git 仓库来说钩子都是本地的，初始的钩子都是从 Git 默认模板目录中自动安装。

在开发团队中为了保持团队所使用钩子一致，维护起来算是比较复杂的，因为 .git/hooks 目录不随你的项目一起拷贝，也不受版本控制影响。

简单的解决办法是把钩子文件存放在项目的实际目录中（在.git 外），这样就可以像其他文件一样进行版本控制，然后在.git/hooks中创建一个链接，或者简单地在更新后把它们复制到.git/hooks目录下。

Git 服务端钩子 Server-Side Hooks

我们自己的开源项目，一般用GitHub，因为不是自家的服务器，只有调用官方的api接口，只有等GitHub通知我们，然后我们服务端监听，

可参看：基于GitHub/Webhook的简单自动化部署架构，一般用github管理项目的，还是少。公司基本都用GitLab

如果做公司的项目，还是自建GitLab服务器，下面将讲解如何在 GitLab 服务器中使用 Server-Side Hooks。

# 替换 group 和 project,注意如果不在该目录的话,则应该是 /home/git/repositories/<group>/<project>.git 目录
cd /var/opt/gitlab/git-data/repositories/<group>/<project>.git
ls
// HEAD  config  description  hooks  info  objects  refs
// 在 hooks 文件夹中存放着 GitLab 定义的钩子脚本
ls hooks
//post-receive  pre-receive  update

创建 custom_hooks 文件夹用于存放自定义钩子脚本

mkdir custom_hooks 

并创建 post-receive 脚本（客户端 push 到 Git 服务器时会触发 post-receive 钩子）

touch post-receive

Git 钩子进行自动部署

如何实现 Git 钩子进行自动部署，其实原理很简单，我们只需要监听每次本地 git push到远程服务器，然后远程服务器同步拉取最新文件，重启服务器即可（pm2 reload xx）。

#demo-brancd 表示demo分支，不写默认master分支
#!/bin/sh
DIR=/home/wwwroot/default #此次为nginx服务器站点代码
git --work-tree=${DIR} clean -fd demo-brancd
git --work-tree=${DIR} checkout --force demo-brancd
chown git:git post-recevice #授权给git用户

参考文章：

用 Git 钩子进行简单自动部署 https://aotu.io/notes/2017/04/10/githooks/

自定义 Git - Git 钩子 https://git-scm.com/book/zh/v2/自定义-Git-Git-钩子

Git Hooks 的使用 https://www.jianshu.com/p/4058c63310b7

基于GitHub/Webhook的简单自动化部署架构 www.tgf21.com/post/fc66e3c5.html

转载本站文章《Git hooks与自动化部署》, 请注明出处：https://www.zhoulujun.cn/html/tools/VCS/git/8319.html