nasqueron/notifications

nasqueron/notifications镜像说明

镜像概述

该镜像用于接收来自GitHub、Phabricator、Docker Hub等平台的Webhook请求，将事件转换为统一格式后发送至指定消息代理（如RabbitMQ、Kafka），支持后续系统对通知事件的处理与集成。

核心功能

• 支持监听GitHub（push、PR、issue等）、Phabricator（任务更新、代码审查）、Docker Hub（镜像推送）的Webhook事件
• 事件格式统一化处理，降低下游系统解析成本
• 轻量级架构，低资源占用，易于部署扩展

使用场景

• 代码协作自动化：接收代码仓库变更通知，触发测试、部署流程
• 镜像发布通知：Docker Hub镜像推送完成后，通知团队或启动后续流程
• 多平台事件汇总：将分散工具的事件统一到消息系统，实现集中监控

配置说明

通过环境变量配置关键参数：

• BROKER_URL：消息代理连接地址（如amqp://user:pass@rabbitmq:5672/）
• WEBHOOK_SECRET：可选，Webhook请求验证密钥（需与平台配置一致）
• LISTEN_PORT：监听端口，默认8080

部署示例

Docker Run命令

bash
docker run -d \
  -p 8080:8080 \
  -e BROKER_URL=amqp://guest:guest@rabbitmq:5672/ \
  -e WEBHOOK_SECRET=your_unique_secret \
  docker.xuanyuan.run/nasqueron/notifications

Docker Compose配置

yaml
version: '3.8'
services:
  notifications:
    image: nasqueron/notifications
    ports: ["8080:8080"]
    environment:
      - BROKER_URL=amqp://guest:guest@rabbitmq:5672/
      - WEBHOOK_SECRET=my_webhook_secret
    depends_on: [rabbitmq]

  rabbitmq:
    image: rabbitmq:3.12-management
    ports: ["5672:5672", "***:***"]
    volumes: [rabbitmq_data:/var/lib/rabbitmq]

volumes:
  rabbitmq_data: