vfarcic/docker-flow-swarm-listener

Docker Flow Swarm Listener 镜像说明

镜像概述

Docker Flow Swarm Listener 是一款监听Docker Swarm集群事件的工具，当集群内服务、节点等资源发生变化时，会自动向指定HTTP端点发送请求，实现服务配置的动态更新与同步。

核心功能

• 实时捕获Docker Swarm关键事件（服务创建/删除/更新、节点加入/离开等）
• 事件触发时向预设URL发送请求，传递事件元数据
• 支持自定义请求方法、头部及参数，适配不同下游服务需求

使用场景

• 配合Docker Flow Proxy自动完成服务注册与注销
• 集群资源变更时触发运维自动化操作（如监控配置更新）
• 同步集群状态至管理系统或日志平台

配置说明

关键环境变量配置：

• DF_NOTIFY_URL: 事件通知的目标HTTP URL（必填）
• DF_NOTIFY_METHOD: 请求方法（默认GET，可选POST等）
• DF_INTERVAL: 事件轮询间隔（默认5秒）
• DF_SERVICE_NAME: 指定监听的服务名称（留空则监听所有服务）

部署示例

Docker Run命令

bash
docker run -d \
  --name swarm-listener \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  -e DF_NOTIFY_URL=http://docker-flow-proxy:8080/v1/reconfigure \
  vfarcic/docker-flow-swarm-listener

Docker Compose示例

yaml
version: '3.8'
services:
  swarm-listener:
    image: vfarcic/docker-flow-swarm-listener
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      DF_NOTIFY_URL: "[***]"
    deploy:
      mode: global
      placement:
        constraints: [node.role == manager]