folioci/mod-data-export

FOLIO - mod-data-export 镜像文档

镜像概述和主要用途

mod-data-export是FOLIO开源图书馆服务平台的核心功能模块，主要提供库存记录的导出服务。该模块作为FOLIO生态系统的一部分，专注于实现库存数据的批量导出，满足图书馆系统中库存信息备份、迁移及外部系统数据交换等需求。

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

核心功能和特性

• 库存记录导出：核心功能为导出库存记录，支持批量处理和导出系统中的库存数据
• 标准化服务端口：默认使用8081端口提供服务，便于服务发现和集成
• 资源配置优化：容器默认内存限制为542,293,850字节（约517MB），确保资源高效利用
• 数据库依赖：需连接数据库以获取库存数据源，支持与FOLIO系统数据库协同工作
• JVM参数预设：默认配置JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0，优化JVM内存使用效率

使用场景和适用范围

适用于基于FOLIO构建的图书馆信息管理系统，具体场景包括：

• 定期导出库存数据进行备份
• 向外部系统（如统计分析平台、报表系统）提供库存数据
• 系统迁移或升级时导出历史库存记录
• 生成库存数据报表所需的原始数据导出

详细使用方法和配置说明

Docker部署示例

基础运行命令

bash
docker run -d \
  --name mod-data-export \
  -p 8081:8081 \
  -e DB_HOST=folio-db \
  -e DB_PORT=5432 \
  -e DB_NAME=okapi_modules \
  -e DB_USER=folio_user \
  -e DB_PASSWORD=secure_password \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  --memory=542293850b \
  folio/mod-data-export

docker-compose配置示例

yaml
version: '3'
services:
  mod-data-export:
    image: folio/mod-data-export
    container_name: mod-data-export
    ports:
      - "8081:8081"
    environment:
      - DB_HOST=folio-db
      - DB_PORT=5432
      - DB_NAME=okapi_modules
      - DB_USER=folio_user
      - DB_PASSWORD=secure_password
      - JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0
    mem_limit: 542293850b
    depends_on:
      - folio-db
  folio-db:
    image: postgres:13
    environment:
      - POSTGRES_DB=okapi_modules
      - POSTGRES_USER=folio_user
      - POSTGRES_PASSWORD=secure_password

核心配置参数说明

环境变量说明

使用注意事项

1. 数据库依赖：必须确保数据库服务已启动并可访问，模块需通过数据库获取库存源数据
2. 端口冲突：若主机8081端口已被占用，需修改端口映射如-p 8082:8081
3. 内存调整：生产环境可根据实际数据量和并发需求调整--memory参数，但不建议低于默认值
4. JVM优化：若需调整JVM参数，可通过JAVA_OPTIONS环境变量覆盖默认配置，如增加-Xms设置初始内存