eduwass/docker-git-webhook

docker-git-webhook

该Docker镜像可将Git仓库代码拉取至数据卷中，供其他容器直接共享使用，同时提供webhook功能监听仓库变更，实现代码的自动拉取更新。

核心功能

• 拉取Git代码到数据卷，支持多容器共享访问
• 通过webhook触发自动拉取，实时同步仓库最新代码
• 支持自定义前置/后置命令及脚本，适配个性化工作流
• 提供SSH密钥配置（含Base64编码选项），保障仓库访问安全

使用场景

• 持续集成/部署（CI/CD）流程中自动同步代码至运行环境
• 多容器服务共享同一代码库的场景
• 需要实时更新代码的开发或测试环境

配置参数

通过-e参数传递环境变量配置：

• GIT_REPO：Git仓库URL（必填）
• GIT_BRANCH：指定拉取分支（可选，默认主分支）
• GIT_EMAIL：Git提交者***（Git操作必需）
• GIT_NAME：Git提交者名称（Git操作必需）
• GIT_HOOK_TOKEN：webhook认证令牌（用于docker-hook监听）
• SSH_KEY：仓库SSH部署私钥（需写权限）
• BASE64_ENCODED_SSH_KEY：是否使用Base64编码的SSH密钥（布尔值）
• STARTUP_COMMANDS：启动脚本末尾执行的命令
• AFTER_PULL_COMMANDS：拉取后执行的命令
• AFTER_PUSH_COMMANDS：推送后执行的命令
• BEFORE_PULL_COMMANDS：拉取前执行的命令
• BEFORE_PUSH_COMMANDS：推送前执行的命令

自定义脚本挂载位置

将.sh脚本挂载到以下路径，在对应步骤执行：

• /custom_scripts/after_pull：拉取完成后执行
• /custom_scripts/after_push：推送完成后执行
• /custom_scripts/before_pull：拉取开始前执行
• /custom_scripts/before_push：推送开始前执行
• /custom_scripts/on_startup：容器启动时执行

部署示例

Docker Run命令

bash
docker run -d \
  -e GIT_REPO=https://github.com/your/repo.git \
  -e GIT_BRANCH=main \
  -e GIT_EMAIL=dev@example.com \
  -e GIT_NAME="Dev Team" \
  -e GIT_HOOK_TOKEN=your_unique_token \
  -v /local/code/path:/git \
  -p 8080:8080 \
  eduwass/docker-git-webhook

（说明：端口映射用于webhook监听，需替换占位符为实际值）

Docker Compose示例

yaml
version: '3'
services:
  git-webhook:
    image: eduwass/docker-git-webhook
    environment:
      - GIT_REPO=https://github.com/your/repo.git
      - GIT_BRANCH=main
      - GIT_EMAIL=***
      - GIT_NAME=Dev Team
      - GIT_HOOK_TOKEN=your_unique_token
    volumes:
      - ./code:/git
      - ./custom_scripts:/custom_scripts
    ports:
      - "8080:8080"