folioorg/mod-inventory-storage

mod-inventory-storage

镜像概述

mod-inventory-storage是FOLIO项目的核心模块之一，主要用于提供库存数据的存储、管理和访问服务，是FOLIO图书馆服务平台的关键组件。该模块需依赖数据库进行数据持久化，并通过Kafka处理消息传递，同时支持与S3存储服务集成，适用于图书馆资源库存数据的后端存储管理。

核心功能和特性

• 模块端口：默认使用8081端口提供服务
• 资源配置：通过JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0配置Java内存占比，优化资源利用
• 数据库依赖：需配置数据库连接以实现数据持久化
• Kafka集成：支持Kafka消息队列，可配置Kafka主机、端口、主题分区数、消息保留时间等参数，用于数据同步和消息传递
• S3集成：支持与S3兼容的存储服务集成，用于MARC数据迁移等场景，可配置S3 URL、桶名称、访问密钥等参数
• 灵活配置：通过环境变量支持多维度参数配置，包括运行环境、功能开关（如ECS_TLR_FEATURE_ENABLED）等

使用场景和适用范围

适用于FOLIO图书馆服务平台的部署环境，作为库存管理模块的后端存储组件，用于存储和管理图书馆资源的库存数据，包括馆藏位置、分类、主题等信息的持久化和访问支持。

使用方法和配置说明

环境变量配置

以下为核心环境变量说明，部署时需根据实际环境调整：

部署示例

Docker Run命令

bash
docker run -d \
  --name mod-inventory-storage \
  -p 8081:8081 \
  -e "DB_HOST=your-db-host" \
  -e "DB_PORT=your-db-port" \
  -e "DB_NAME=your-db-name" \
  -e "DB_USER=your-db-user" \
  -e "DB_PASSWORD=your-db-password" \
  -e "KAFKA_HOST=kafka" \
  -e "KAFKA_PORT=9092" \
  -e "S3_URL=http://your-s3-service:9000/" \
  -e "S3_ACCESS_KEY_ID=your-access-key" \
  -e "S3_SECRET_ACCESS_KEY=your-secret-key" \
  folio/mod-inventory-storage

注意事项

1. 部署前需确保数据库和Kafka服务已启动并可访问
2. 根据实际需求调整Kafka主题分区数、S3配置等参数
3. 内存配置可通过JAVA_OPTIONS调整，根据容器资源分配优化MaxRAMPercentage值