folioci/mod-inventory

FOLIO - mod-inventory

镜像概述

mod-inventory是FOLIO图书馆服务平台的核心模块之一，专注于图书馆资源的库存管理，提供库存数据的存储、查询、更新等功能。该模块需依赖数据库存储数据，并支持与KAFKA消息系统集成以实现数据同步。

代码仓库：https://github.com/folio-org/mod-inventory

核心功能与特性

• 服务端口：默认使用9403端口提供HTTP服务
• 数据库依赖：需配置数据库连接（Database connection: true），依赖数据库存储库存数据
• 资源需求：建议容器内存不低于715827883字节（约683MB）
• Java配置：默认JAVA_OPTIONS为-XX:MaxRAMPercentage=66.0 -Dorg.folio.metadata.inventory.storage.type=okapi，用于内存优化及存储类型指定
• KAFKA集成：支持通过KAFKA_HOST和KAFKA_PORT环境变量配置KAFKA连接，实现消息通知功能

使用场景

适用于基于FOLIO平台构建的图书馆管理系统，用于管理各类图书馆资源（如图书、期刊、电子资源等）的库存信息，包括但不限于：

• 资源入库登记与元数据管理
• 库存状态实时更新与查询
• 资源出库跟踪与历史记录管理
• 库存数据同步与外部系统集成

使用方法与配置说明

环境变量配置

Docker运行示例

bash
docker run -d \
  --name mod-inventory \
  -p 9403:9403 \
  -e KAFKA_HOST=kafka.example.com \
  -e KAFKA_PORT=9092 \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0 -Dorg.folio.metadata.inventory.storage.type=okapi" \
  -e DB_HOST=db.example.com \
  -e DB_PORT=5432 \
  -e DB_NAME=folio_inventory \
  -e DB_USER=folio_user \
  -e DB_PASSWORD=secure_password \
  --memory=683m \
  folio/mod-inventory:latest

注意事项

1. 内存配置：通过--memory=683m指定容器内存，需不低于715827883字节（约683MB）。
2. 数据库依赖：必须配置完整的数据库连接参数，模块无法脱离数据库独立运行。
3. KAFKA配置：仅在需要消息通知或数据同步时配置KAFKA_HOST和KAFKA_PORT。
4. 扩展配置：更多高级配置（如日志级别、连接池参数等）请参考代码仓库文档。