FOLIO - mod-pubsub

镜像概述和主要用途

mod-pubsub是FOLIO项目的核心模块之一，作为发布-订阅（Publish-Subscribe）组件，旨在为FOLIO生态系统提供事件驱动架构支持。该模块通过实现发布-订阅机制，支持系统内各组件间的异步通信、事件传递与处理，是构建松耦合微服务架构的关键组件。

核心功能和特性

• 发布-订阅机制：提供事件的发布与订阅能力，支持多生产者、多消费者模式，实现组件间的解耦通信
• 事件驱动支持：基于事件的异步处理模式，提升系统对动态业务场景的响应能力和可扩展性
• FOLIO生态集成：适配FOLIO系统技术栈，支持与Okapi服务注册中心、Kafka消息队列等核心组件协同工作

使用场景和适用范围

适用于FOLIO系统中需要组件间异步通信的场景，包括但不限于：

• 微服务间的事件通知（如订单状态变更、用户操作记录等）
• 跨模块业务流程触发（如库存更新触发订单处理、元数据变更触发索引更新等）
• 系统状态监控与日志聚合（通过事件收集各模块运行状态信息）

使用方法和配置说明

基础配置信息

环境变量配置

Docker部署示例

bash
docker run -d \
  --name mod-pubsub \
  -p 8081:8081 \
  -e KAFKA_HOST=kafka-service \  # 替换为实际Kafka服务地址
  -e KAFKA_PORT=9092 \
  -e OKAPI_URL=[***] \  # 替换为实际Okapi服务地址
  -e SYSTEM_USER_PASSWORD=SecurePassword123 \  # 替换为安全密码
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0 -XX:+HeapDumpOnOutOfMemoryError" \
  --memory=1g \
  folio/mod-pubsub

注意事项

1. 需确保Kafka服务和Okapi服务可被容器访问，网络配置需匹配实际部署环境
2. 系统用户密码（SYSTEM_USER_PASSWORD）需使用强密码，并通过环境变量注入，避免硬编码
3. 数据库连接需额外配置（如DB_HOST、DB_PORT、DB_NAME等参数，具体依赖数据库类型），确保模块能正常初始化数据结构
4. 内存限制建议不低于1GB，生产环境可根据负载情况调整JVM参数（通过JAVA_OPTIONS）