php项目使用git的webhooks实现自动部署

前言

在项目开发中使用git进行代码的管理,每次完成更改上传代码后,还需要登录服务器将代码拉取下来.现在git服务器(gitee/gitlab/github)都会有Webhooks功能,以实现在向git仓库推送/合并等时机让服务器自动拉取新代码.

流程说明

使用Webhooks后,整个上传部署流程如下:

服务器端操作

webhook脚本创建

关于推送的post数据格式,参考码云的《WebHook 推送数据格式说明》.根据这个参数格式编写php的脚本文件如下:

    <?php
    /**
      *git webhook 自动部署脚本
      */
    //接收post参数
    $requestBody = file_get_contents("php://input");
    if (empty($requestBody)) {
        exit('data null');
    }
    $content = json_decode($requestBody, true);
    
    //验证密码,验证码云上配置的webhook密码
    //if (empty($content['password']) || $content['password'] != 'password') //{
    //	exit('password error');
    //}
    
    $path = "/var/www/test/"; //项目存放物理路径
    //判断master分支上是否有提交
    if ($content['ref']=='refs/heads/master' && $content['total_commits_count']>0) {
        $res = shell_exec("cd {$path} && git pull origin master 2>&1");//当前为www用户
        $res_log = '------------------------->'.PHP_EOL;
        $res_log .= '用户'. $content['user_name'] . ' 于' . date('Y-m-d H:i:s') . '向' . $content['repository']['name'] . '项目的' . $content['ref'] . '分支push了' . $content['total_commits_count'] . '个commit：' . PHP_EOL;
        $res_log .= $res.PHP_EOL;
        $x = file_put_contents("git_webhook_log.txt", $res_log, FILE_APPEND);//追加写入日志文件
        if ($x) {
        	echo 'true-';
        } else {
        	echo 'false-';
        }
    }
    echo 'done';

服务器用户设置

由于是通过url请求php编写的脚本执行操作,所以打开nginx.conf文件查看执行用户,默认为www,也可在任意php文件中添加代码: echo system("whoami");,然后访问文件查看php运行用户.
确定用户后,打开/etc/passwd文件查看该用户的信息,如下:

    www:x:1000:1000::/var/www:/bin/bash

其格式和具体含义如下：

用户名:口令:用户标识号:组标识号:注释性描述:主目录:登录Shell

其中要注意"主目录"这一项,若后续操作提示该目录不存在或错误,打开此文件修改.
接着依次执行下面三条命令:

    su - www //切换到www用户
    ssh-keygen -t rsa -C "test@gmail.com" //以邮箱为名创建rsa密钥
    cat /var/www/.ssh/id_rsa.pub //查看rsa公钥并复制,.ssh所在目录即上面所提"主目录"

git仓库操作

配置部署公钥

在码云上打开项目仓库,依次点击[管理]=>[部署公钥管理]=>[添加公钥].将上面复制的id_rsa.pub公钥添加进来.完成后在服务器上执行命令:

    ssh -T git@gitee.com

首次使用会提示the authenticity of host 'gitee.com...需要输入yes确认并添加主机到本机SSH可信列表.若返回 Hi XXX! You've successfully authenticated, but Gitee.com does not provide shell access. 内容，则证明添加成功.添加成功后，当前账户www就可以使用SSH协议对仓库进行克隆/拉取等操作了.

添加webhook

在码云上打开项目仓库,依次点击[管理]=>[WebHooks]=>[添加],填写webhook的php脚本地址,如有需要填写webhook密码/密钥(密钥需要再添加验签),如下图

到此,完成配置,之后的push操作可在码云[WebHooks 管理]中查看自动部署请求记录信息.也可查看服务器中的git_webhook_log.txt部署日志(php脚本中写入,不需要可注释掉).