forked from Holyhi / git-webhooks-server

加入 Gitee

与超过 1200万开发者一起发现、参与优秀开源项目，私有仓库也完全免费：）

克隆/下载

README.zh.md 3.12 KB

# 简易 Git WebHooks 服务

[README](README.md) | [中文说明](README.zh.md)

# 目录
- [简介](#简介)
- [安装](#安装)
- [卸载](#卸载)
- [使用](#使用)
  - [Github:](#github)
  - [Gitee:](#gitee)
  - [Gitlab:](#gitlab)
  - [自定义:](#自定义)
- [配置](#配置)

## 简介
- 使用 Python 3 实现的.
- 支持 Github、Gitee、Gitlab 及自定义仓库.
- 支持为不同的仓库指定工作目录和命令.
- 支持安装为 Systemd 服务.

## 安装

- 克隆到任意目录.
- 执行 `./install.sh` 进行安装.
```shell
git clone https://github.com/troytse/git-webhooks-server.git
cd git-webhooks-server
./install.sh
```
![install](doc/install.png)

## 卸载

```shell
cd git-webhooks-server
./install.sh --uninstal
```
![uninstall](doc/uninstall.png)

## 使用

- 在配置文件中添加仓库信息:
```ini
# 匹配你的仓库全名
[your_name/repository]
# 工作目录
cwd=/path/to/your/repository
# 收到推送后执行的命令
cmd=git fetch --all & git reset --hard origin/master & git pull
```

- 重新启动服务
```shell
systemctl restart git-webhooks-server
```

- 在你的仓库设置中添加 webhook:
### Github:

![github](doc/github.png)
![github-success](doc/github-success.png)

### Gitee:

![gitee](doc/gitee.png)
![gitee-success](doc/gitee-success.png)

### Gitlab:

![gitlab](doc/gitlab.png)
![gitlab-success](doc/gitlab-success.png)

### 自定义: 
- 对于自定义 webhooks 来源, 你需要像下面这样调整你的配置文件:
```ini
[custom]
# 用于识别来源
header_name=X-Custom-Header
header_value=Custom-Git-Hookshot
# 用于匹配 secret 的 header
header_token=X-Custom-Token
# 仓库名称在JSON请求数据中的位置
identifier_path=project.path_with_namespace
# 仅支持文本Token的认证
verify=True
secret=123456
```
- 处理器接受 `application/json` 或 `application/x-www-form-urlencoded` 格式的请求 (你可以参考 [Github](https://developer.github.com/webhooks/event-payloads/#example-delivery) / [Gitee](https://gitee.com/help/articles/4186) / [Gitlab](https://gitlab.com/help/user/project/integrations/webhooks#push-events) 中关于请求的指引), 数据格式像这样:
```json
{
  "project": {
    "path_with_namespace": "your_name/repository"
  }
}
```
![custom-header](doc/custom-header.png)
![custom-body](doc/custom-body.png)
![custom-response](doc/custom-response.png)

## 配置

- 默认配置文件位置: `/usr/local/etc/git-webhooks-server.ini`.
- 你可以在安装后修改它.
- 一个典型的配置文件如下:

```ini
[server]
address=0.0.0.0
port=6789
log_file=/var/log/git-webhooks-server.log

[ssl]
enable=False
key_file=/path/to/key.pem
cert_file=/path/to/cert.pem

[github]
verify=True
secret=123456

[gitee]
verify=True
secret=123456

[gitlab]
verify=True
secret=123456

[custom]
header_name=X-Custom-Header
header_value=Custom-Git-Hookshot
header_token=X-Custom-Token
identifier_path=project.path_with_namespace
verify=True
secret=123456

[your_name/repository]
cwd=/path/to/your/repository
cmd=git fetch --all & git reset --hard origin/master & git pull

[your_name/sample]
cwd=/path/to/sample
cmd=git fetch --all & git reset --hard origin/master & git pull
```

一键复制编辑原始数据按行查看历史

提交于 2020-06-11 02:51 . add support to SSL

简易 Git WebHooks 服务

README | 中文说明

目录

简介
安装
卸载
使用
- Github:
- Gitee:
- Gitlab:
- 自定义:
配置

简介

使用 Python 3 实现的.
支持 Github、Gitee、Gitlab 及自定义仓库.
支持为不同的仓库指定工作目录和命令.
支持安装为 Systemd 服务.

安装

克隆到任意目录.
执行 ./install.sh 进行安装.

git clone https://github.com/troytse/git-webhooks-server.git
cd git-webhooks-server
./install.sh

install

卸载

cd git-webhooks-server
./install.sh --uninstal

uninstall

使用

在配置文件中添加仓库信息:

# 匹配你的仓库全名
[your_name/repository]
# 工作目录
cwd=/path/to/your/repository
# 收到推送后执行的命令
cmd=git fetch --all & git reset --hard origin/master & git pull

重新启动服务

systemctl restart git-webhooks-server

在你的仓库设置中添加 webhook:

Github:

github github-success

Gitee:

gitee gitee-success

Gitlab:

gitlab gitlab-success

自定义:

对于自定义 webhooks 来源, 你需要像下面这样调整你的配置文件:

[custom]
# 用于识别来源
header_name=X-Custom-Header
header_value=Custom-Git-Hookshot
# 用于匹配 secret 的 header
header_token=X-Custom-Token
# 仓库名称在JSON请求数据中的位置
identifier_path=project.path_with_namespace
# 仅支持文本Token的认证
verify=True
secret=123456

处理器接受 application/json 或 application/x-www-form-urlencoded 格式的请求 (你可以参考 Github / Gitee / Gitlab 中关于请求的指引), 数据格式像这样:

{
  "project": {
    "path_with_namespace": "your_name/repository"
  }
}

custom-header custom-body custom-response

配置

默认配置文件位置: /usr/local/etc/git-webhooks-server.ini.
你可以在安装后修改它.
一个典型的配置文件如下:

[server]
address=0.0.0.0
port=6789
log_file=/var/log/git-webhooks-server.log

[ssl]
enable=False
key_file=/path/to/key.pem
cert_file=/path/to/cert.pem

[github]
verify=True
secret=123456

[gitee]
verify=True
secret=123456

[gitlab]
verify=True
secret=123456

[custom]
header_name=X-Custom-Header
header_value=Custom-Git-Hookshot
header_token=X-Custom-Token
identifier_path=project.path_with_namespace
verify=True
secret=123456

[your_name/repository]
cwd=/path/to/your/repository
cmd=git fetch --all & git reset --hard origin/master & git pull

[your_name/sample]
cwd=/path/to/sample
cmd=git fetch --all & git reset --hard origin/master & git pull

Python

1

https://gitee.com/distributed-db/git-webhooks-server.git

git@gitee.com:distributed-db/git-webhooks-server.git

distributed-db

git-webhooks-server

git-webhooks-server

master