folioorg/mod-source-record-storage

FOLIO - mod-source-record-storage

镜像概述和主要用途

mod-source-record-storage是FOLIO项目的核心模块之一，主要提供持久化源记录存储功能。该模块旨在为FOLIO生态系统提供稳定、可靠的源记录持久化存储解决方案，支持与数据库及Kafka等组件集成。

代码仓库：https://github.com/folio-org/mod-source-record-storage

核心功能和特性

• 持久化存储：提供源记录的持久化存储能力，确保数据稳定可靠
• 数据库支持：需配置数据库连接（Database connection: true），依赖外部数据库服务
• 固定端口：模块默认端口为8081，便于服务发现与通信
• 资源控制：容器内存限制为1GB（***字节），预设JVM参数优化性能
• Kafka集成：支持通过环境变量配置Kafka连接信息，实现与消息队列的集成

使用场景和适用范围

适用于FOLIO生态系统中需要管理和存储源记录的场景，作为FOLIO服务架构的关键组件，支持图书馆、学术机构等组织的元数据管理、资源记录持久化及相关业务流程。

使用方法和配置说明

部署示例

Docker Run命令

bash
docker run -d \
  -p 8081:8081 \
  -e KAFKA_HOST=10.0.2.15 \
  -e KAFKA_PORT=9092 \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0 -Djava.util.logging.config.file=vertx-default-jul-logging.properties" \
  --memory=1g \
  folio/mod-source-record-storage

配置参数说明

基础配置

• 模块端口：8081（容器内固定端口，建议映射至宿主机对应端口）
• 容器内存：1GB（***字节，运行时需确保容器有足够内存资源）
• 数据库连接：需配置外部数据库连接参数（模块依赖数据库，具体配置需参考FOLIO数据库集成文档）

环境变量

• KAFKA_HOST：Kafka服务主机地址，默认值为10.0.2.15
• KAFKA_PORT：Kafka服务端口，默认值为9092

JVM参数

预设JAVA_OPTIONS：-XX:MaxRAMPercentage=66.0 -Djava.util.logging.config.file=vertx-default-jul-logging.properties，用于优化JVM内存使用及日志配置