andyceo/dockerhub-webhooks

概述

本工具可监听Docker Hub发送的Webhook事件，并在触发时自动（重新）部署Docker Swarm上的服务和堆栈，帮助实现镜像更新后的自动化部署流程。

核心功能

• 监听Docker Hub的Webhook通知
• 自动触发Docker Swarm服务或堆栈的部署/更新操作
• 支持通过配置文件自定义部署逻辑

使用场景

• Docker Swarm集群中，当Docker Hub镜像更新时自动部署最新版本服务
• 持续集成/持续部署（CI/CD）流程中，镜像构建完成后自动同步更新Swarm环境
• 简化Swarm集群的日常部署维护操作

配置说明

1. 配置文件：参考镜像内的config-sample.json获取配置示例，需自定义部署规则
2. 卷挂载要求：
   • config.json：挂载自定义配置文件到容器内对应路径
   • docker.sock：挂载本地Docker套接字（/var/run/docker.sock）以执行Swarm命令
   • 堆栈目录：若使用堆栈部署，需挂载本地堆栈文件目录到容器内指定路径

部署示例

Docker Run命令

bash
docker run -d \
  --name dockerhub-webhooks \
  -v /your/local/config.json:/app/config.json \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /your/local/stacks:/stacks \
  andyceo/dockerhub-webhooks

说明

• 替换/your/local/config.json为本地配置文件路径
• 替换/your/local/stacks为本地堆栈文件目录（若使用堆栈部署）
• 容器需具备访问Docker套接字的权限以执行部署操作