folioci/mod-circulation-storage Docker 镜像 - 轩辕镜像

FOLIO - mod-circulation-storage

镜像概述和主要用途

mod-circulation-storage是FOLIO图书馆服务平台的核心模块之一，负责图书馆流通业务相关数据（如借阅记录、续借信息、流通规则等）的持久化存储与管理，为FOLIO系统的流通功能提供底层数据支撑，确保流通业务数据的可靠存储与高效访问。

核心功能和特性

• 端口配置：默认监听8081端口，提供服务访问接口
• 内存管理：容器内存限制为536870912字节（512MB），通过JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0优化Java内存使用效率
• 数据库依赖：需配置外部数据库连接以实现数据持久化存储
• Kafka集成：支持与Kafka消息系统集成，通过环境变量配置Kafka连接信息（主机、端口、副本因子）
• 环境标识：默认通过ENV=folio指定运行环境为FOLIO平台

使用场景和适用范围

适用于基于FOLIO构建的图书馆服务平台，作为流通业务模块（如mod-circulation）的底层数据存储组件，支持图书馆日常流通业务（如图书借阅、归还、续借、预约等）的数据管理需求，需与FOLIO其他服务模块及数据库、Kafka服务协同部署。

使用方法和配置说明

基本部署命令

使用docker run部署示例（需提前配置数据库和Kafka服务）：

bash
docker run -d \
  -p 8081:8081 \
  -e DB_HOST=<数据库主机地址> \
  -e DB_PORT=<数据库端口> \
  -e DB_NAME=<数据库名称> \
  -e DB_USER=<数据库用户名> \
  -e DB_PASSWORD=<数据库密码> \
  -e KAFKA_HOST=kafka \
  -e KAFKA_PORT=9092 \
  -e REPLICATION_FACTOR=1 \
  -e ENV=folio \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  --memory=512m \
  folioorg/mod-circulation-storage

注：<数据库主机地址>、<数据库端口>、<数据库名称>、<数据库用户名>、<数据库密码>需替换为实际数据库配置信息。

配置参数说明

环境变量

端口配置

• 容器内部端口：8081（建议通过-p 8081:8081映射到主机端口）

资源限制

• 容器内存：建议设置为512MB（536870912字节），通过--memory=512m限制容器内存使用

Java选项

• 默认JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0：允许Java进程使用容器内存的66%（约338MB），可根据实际需求调整该参数