cryptkiddie2/webhook-docker

webhook-docker

镜像概述

webhook-docker是一个集成webhook与Docker功能的工具镜像，主要用途是通过接收webhook请求来触发Docker容器的重新加载或生成操作，实现基于webhook事件的Docker容器自动化管理。

核心功能与特性

• webhook与Docker集成：将webhook服务与Docker引擎功能结合，支持通过HTTP请求触发容器操作
• 容器管理操作：支持对Docker容器执行重新加载（reload）和生成（spawn）等操作
• 事件驱动：通过外部webhook事件（如代码提交、配置更新等）触发容器变更，减少手动干预
• 轻量级设计：无需复杂的外部依赖，可直接与Docker环境集成

使用场景与适用范围

• CI/CD流程集成：在代码提交或构建完成后，通过webhook自动更新应用容器
• 配置变更自动部署：当配置文件更新后，触发容器重新加载以应用新配置
• 远程容器管理：通过外部系统发送webhook请求，远程触发容器生成或更新
• 微服务动态扩缩容：根据特定事件通过webhook触发新容器生成，实现动态扩缩容

使用方法与配置说明

基本运行命令

bash
docker run -d \
  -p 9000:9000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --name webhook-docker \
  webhook-docker

参数说明：

• -p 9000:9000：映射webhook服务端口（默认9000）
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker socket，使容器能够与Docker引擎通信

配置webhook端点

默认webhook端点为/hook，可通过发送HTTP POST请求到http://<容器IP>:9000/hook触发容器操作。

环境变量配置

docker-compose配置示例

yaml
version: '3'
services:
  webhook-docker:
    image: webhook-docker
    ports:
      - "9000:9000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WEBHOOK_PORT=9000
      - WEBHOOK_PATH=/hook
    restart: always

触发容器操作

发送POST请求到webhook端点，请求体中可包含需要执行的容器操作参数，例如：

bash
curl -X POST http://localhost:9000/hook \
  -H "Content-Type: application/json" \
  -d '{"action": "reload", "container": "my-app-container"}'

支持的操作：

• reload：重新加载指定容器
• spawn：生成新的容器实例（需额外提供容器镜像、名称等参数）