faucet/event-adapter-rabbitmq-pi

RabbitMQ事件通知适配器

镜像概述和主要用途

该Docker镜像为Faucet的RabbitMQ事件适配器，专门用于armhf架构。它能够连接Faucet推送事件的Unix套接字，接收事件并通过RabbitMQ进行转发，是与Poseidon集成的关键组件。

核心功能和特性

• 事件接收：挂钩到Faucet推送事件的Unix套接字，实时接收事件数据
• Poseidon集成：Poseidon必需此适配器，不支持仅日志解析的方式
• 配置灵活：支持通过环境变量配置RabbitMQ连接参数（主机、端口、交换机等）
• 便捷部署：提供Docker Compose配置文件，支持快速部署和集成
• 测试支持：包含示例RabbitMQ消费者，便于测试和开发验证

使用场景和适用范围

适用于需要通过RabbitMQ接收Faucet网络事件通知的场景，尤其在与Poseidon配合使用时，用于网络事件处理、监控和自动化响应。

使用方法和配置说明

环境变量配置

以下环境变量用于配置适配器行为：

与Poseidon配合使用

• Poseidon必须使用此适配器，不支持仅日志解析模式
• Poseidon自带RabbitMQ服务器，无需单独启动RabbitMQ服务
• 需将FA_RABBIT_HOST设置为Poseidon运行的IP地址，确保适配器能连接到Poseidon的RabbitMQ服务器

Docker Compose部署步骤

1. 从FAUCET顶层目录导出必要的环境变量：

   bash
   export FAUCET_EVENT_SOCK=1
   export FA_RABBIT_HOST=<Poseidon或RabbitMQ服务器IP>
   # 可选配置其他环境变量
   

2. 启动适配器（与Poseidon配合，使用其自带RabbitMQ）：

   bash
   docker-compose -f docker-compose.yaml \
                  -f adapters/vendors/rabbitmq/docker-compose.yaml \
                  up
   

3. 如需独立RabbitMQ服务器（用于测试或非Poseidon场景）：

   bash
   docker-compose -f docker-compose.yaml \
                  -f adapters/vendors/rabbitmq/docker-compose-rabbitmq.yaml \
                  -f adapters/vendors/rabbitmq/docker-compose.yaml \
                  up
   

示例消费者使用

提供示例RabbitMQ消费者用于测试和开发，默认连接上述部署的RabbitMQ服务器：

1. 安装依赖：

   bash
   pip3 install -r adapters/vendors/rabbitmq/requirements.txt
   

2. 运行消费者（确保RabbitMQ服务已启动）：

   bash
   python3 adapters/vendors/rabbitmq/example_consumer.py
   

   注：如使用独立RabbitMQ服务器，需设置FA_RABBIT_HOST=rabbitmq