folioci/mod-lists

FOLIO - mod-lists镜像文档

镜像概述

mod-lists是FOLIO平台的列表后端模块，主要提供列表管理、导出及相关后端服务支持，包括列表数据处理、批量导出、存储集成等功能，是FOLIO生态系统中处理列表数据的核心组件。

核心功能与特性

• 基础服务配置：默认端口8081，支持JVM参数优化（如-XX:MaxRAMPercentage=66.0等）
• 数据库集成：需数据库连接支持，用于列表数据持久化存储
• 列表配置管理：支持设置最大列表大小（MAX_LIST_SIZE=1250000）、列表导出批处理大小（LIST_EXPORT_BATCH_SIZE=1000）
• S3存储集成：支持S3兼容存储配置，包括存储桶（S3_BUCKET）、区域（S3_REGION）、访问密钥等参数，可用于列表数据导出存储
• 任务执行管理：配置任务执行池最大大小（spring.task.execution.pool.max-size=10），优化并发任务处理
• 系统集成：支持与OKAPI服务集成（OKAPI_URL=http://okapi:9130），包含系统用户配置（SYSTEM_USER_PASSWORD）及查询超时设置（REFRESH_QUERY_TIMEOUT_MINUTES=90）

使用场景与适用范围

适用于FOLIO生态系统中需要处理列表数据的后端服务场景，如：

• 列表数据的创建、管理与持久化存储
• 大规模列表数据的批量导出与S3存储备份
• 与FOLIO平台其他组件（如OKAPI）协同工作，提供列表相关后端API支持
• 图书馆管理系统、信息资源管理平台等需要处理结构化列表数据的场景

使用方法与配置说明

Docker部署示例

基础运行命令

bash
docker run -d \
  -p 8081:8081 \
  --env OKAPI_URL=http://okapi:9130 \
  --env DB_HOST=your-db-host \
  --env DB_PORT=5432 \
  --env DB_NAME=folio_mod_lists \
  --env DB_USER=folio_user \
  --env DB_PASSWORD=your-db-password \
  --env S3_BUCKET=your-s3-bucket \
  --env S3_ACCESS_KEY_ID=your-access-key \
  --env S3_SECRET_ACCESS_KEY=your-secret-key \
  folioorg/mod-lists

配置参数说明

基础配置

列表核心配置

S3存储配置

系统集成配置

任务执行配置

注意事项

• 需确保数据库服务已部署并可访问，模块依赖数据库连接
• S3相关参数需根据实际存储环境配置，若无需S3存储可留空
• OKAPI_URL需指向FOLIO平台的OKAPI服务地址，确保模块能正常注册与通信
• 可通过调整JAVA_OPTIONS优化JVM内存使用，适应不同部署环境需求