Gitee Webhook 实现自动拉取代码并编译代码

1、Webhook 介绍与做用简介

Webhook，顾名思义就是钩子，简而言之，能够在特定状况下触发特定的操做。例如在远程git仓库中进行了push、tag等操做时，自动在远程server端自动拉取、编译代码。 如下是一个push代码到远程仓库后，自动拉取代码进行编译后，将生成的Webassembly相关的文件（.js，.wasm）和版本号push到远程仓库中的demo。

2、demo实现

1. 仓库设置（以gitee为例）

首先，须要拥有项目的管理者权限，点击项目首页上方的管理，而后点击左侧菜单下方的WebHooks，进入到如下截图的设置页面。

]

在上面的的界面中，我已经添加了一个Webhook，触发类型为push，同时还有一个密码。 当你push代码到远程仓库时，会往这里设置的URL发送一个携带着设置好密码的POST请求。固然你也能够勾选其余的操做类型。

2. PHP代码实现

• hooks.php

<?php

// 本地仓库路径
$local = '/data/wwwroot/default/hooks/laserbox';

// 安全验证字符串，为空则不验证
$token = '123456';

//  payload为字符串，须要通过解析
$payload = file_get_contents('php://input');
if (!$payload) {
    header('HTTP/1.1 400 Bad Request');
    die('HTTP HEADER or POST is missing.');
}
$content = json_decode($payload, true);

// 若是启用验证，而且验证失败，返回错误
if ($token && $content['password'] != $token) {
    header('HTTP/1.1 403 Permission Denied');
    die('Permission denied.');
}

//最后会执行一个脚本编译代码，而后再push代码到远程
//因此会重复触发WebHooks，所以此处判断是不是本地的推送
if($content['commits'][0]['author']['name'] == 'handsomeTaoTao'){
        header('HTTP/1.1 403 Permission Denied');
        die('self push.');
}

/*
 * 这里有几点须要注意：
 *
 * 1.确保PHP正常执行系统命令。写一个PHP文件，内容：
 * `<?php echo shell_exec('ls -la')`
 * 在经过浏览器访问这个文件，可以输出目录结构说明PHP能够运行系统命令。
 *
 * 二、PHP通常使用www-data或者nginx用户运行，PHP经过脚本执行系统命令也是用这个用户，
 * 在经过浏览器访问这个文件，可以输出目录结构说明PHP能够运行系统命令。
 *
 * 二、PHP通常使用www-data或者nginx用户运行，PHP经过脚本执行系统命令也是用这个用户，
 * 因此必须确保在该用户家目录（通常是/home/www-data或/home/nginx）下有.ssh目录和
 * 一些受权文件，以及git配置文件，以下：
 * ```
 * + .ssh
 *   - authorized_keys
 *   - config
 *   - id_rsa
 *   - id_rsa.pub
 *   - known_hosts
 * - .gitconfig
 * ```
 *
 * 3.在执行的命令后面加上2>&1能够输出详细信息，肯定错误位置
 *
 * 4.git目录权限问题。好比：
 * `fatal: Unable to create '/data/www/html/awaimai/.git/index.lock': Permission denied`
 * 那就是PHP用户没有写权限，须要给目录授予权限:
 * ``
 * sudo chown -R :www-data /data/www/html/awaimai`
 * sudo chmod -R g+w /data/www/html/awaimai
 * ```
 *
 * 5.SSH认证问题。若是是经过SSH认证，有可能提示错误：
 * `Could not create directory '/.ssh'.`
 * 或者
 * `Host key verification failed.`
 *
 */

// shell_exec函数默认是禁止的，没法使用的话须要进php.ini修改相关配置
//执行shell时，没有sudo仿佛会执行不成功，只执行一小段，加了sudo以后执行成功，能够为运行php的用户添加sudo权限，参考资料有相关问题
echo shell_exec("cd {$local} && sudo sh ./autoCompiled.sh");
die("done " . date('Y-m-d H:i:s', time()));
复制代码

---

• autoCompiled.sh

#!/bin/sh
source /data/git/emsdk/emsdk_env.sh  // 载入命令，不然在命令行中没法使用emcc等编译用的命令
cd  /data/git/Webassembly-Lib/Demo/  // 进入到执行命令的目录中
git pull
rm -f src/version.h
git rev-list HEAD | sort > config.git-hash
LOCALVER=`wc -l config.git-hash | awk '{print $1}'`
if [ $LOCALVER \> 1 ] ; then
    VER=`git rev-list origin/master | sort | join config.git-hash - | wc -l | awk '{print $1}'`
    if [ $VER != $LOCALVER ] ; then
        VER="$VER+$(($LOCALVER-$VER))"
    fi
    if git status | grep -q "modified:" ; then
        VER="${VER}M"
    fi
    VER="$VER $(git rev-list HEAD -n 1 | cut -c 1-7)"
    GIT_VERSION=r$VER
else
    GIT_VERSION=
    VER="x"
fi
rm -f config.git-hash

cat version.h.template | sed "s/\$FULL_VERSION/$GIT_VERSION/g" > src/version.h


# 编译和提交代码
make
git add .
git commit -m 'Auto Compiled By handsomeTaoTao' 
git push

复制代码

3、结束语

目前这个demo还只是实现了比较简单的功能，能够进一步优化功能，例如在浏览器访问该地址时显示上一次编译是否成功的信息，失败的话则显示错误信息，这样子能够方便调试。

---

参考资料
stackoverflow: php-sudo-in-shell-exec
Gitee 配置文档
Github、GitLab、Gitee使用Webhooks实现代码自动部署