adrianharabula/webhook

基于almir/webhook并预装Git的Docker镜像

镜像概述

本镜像基于公开镜像 https://hub.docker.com/r/almir/webhook/ 构建，额外集成Git工具，专注于通过Webhook机制实现Git仓库的自动拉取，适用于代码自动部署、仓库同步等场景。

核心功能

1. 接收Webhook HTTP请求并执行指定脚本（如Git拉取）
2. 支持SSH密钥配置，兼容私有Git仓库访问
3. 提供hooks配置文件热重载能力，无需重启容器即可更新规则
4. 支持详细日志输出，便于问题排查

使用场景

• 代码自动部署：当GitHub/GitLab仓库有新提交时，触发服务器拉取最新代码并更新应用
• 多环境同步：通过Webhook同步Git仓库内容到测试/生产环境
• 定时或事件驱动的仓库更新：结合外部调度工具实现周期性拉取

配置说明

1. 生成SSH密钥：执行ssh-keygen -f id_rsa生成密钥对（无需设置密码）
2. 配置仓库权限：将id_rsa.pub上传至Git仓库作为部署密钥（需开启写权限）
3. 准备文件目录：
   • 创建hooks.json定义Webhook规则（如路径/hooks/pull对应执行pull.sh）
   • 编写pull.sh脚本（包含cd /root/gitrepo && git pull origin master等命令）
4. 设置权限：
   • 私有密钥：chmod 400 webhook/.ssh/id_rsa
   • 脚本文件：chmod +x webhook/scripts/pull.sh

部署示例

Docker Run命令

bash
docker run -d -p 9000:9000 \
-v /本地路径/webhook/hooks.json:/etc/webhook/hooks.json \
-v /本地路径/webhook/scripts/pull.sh:/var/scripts/pull.sh \
-v /本地路径/webhook/.ssh:/root/.ssh \
-v /本地路径/gitrepo:/root/gitrepo \
--name=webhook adrianharabula/webhook \
-verbose -hooks=/etc/webhook/hooks.json -hotreload

Docker Compose配置

yaml
version: '3'

services:
  webhook:
    image: adrianharabula/webhook
    restart: always
    volumes:
      - "/本地路径/webhook/hooks.json:/etc/webhook/hooks.json"
      - "/本地路径/webhook/scripts:/var/scripts"
      - "/本地路径/webhook/.ssh:/root/.ssh"
      - "/本地路径/gitrepo:/root/gitrepo"
    command: "-verbose -hooks=/etc/webhook/hooks.json -hotreload"
    ports:
      - "9000:9000"

触发测试

访问http://localhost:9000/hooks/pull即可触发Git仓库拉取操作（需确保配置文件和路径正确）