folioorg/mod-rtac

FOLIO - mod-rtac 镜像文档

镜像概述

mod-rtac是FOLIO（图书馆开放源代码服务平台）的核心功能模块，主要用于提供图书馆资源的实时可用性检查服务。该模块通过标准化接口支持资源状态的实时查询，为图书馆用户及集成系统提供准确的资源可用性信息。代码仓库：https://github.com/folio-org/mod-rtac

核心功能与特性

• 实时可用性查询：支持图书馆各类资源（如图书、期刊、电子资源等）的实时状态检查
• 标准化接口：提供符合FOLIO平台规范的API，便于与其他模块（如检索系统、用户门户）集成
• 轻量级部署：无需数据库依赖（数据库连接配置为false），降低系统部署复杂度
• 可配置运行参数：支持通过环境变量自定义JVM运行参数，优化性能与资源占用

使用场景与适用范围

• 图书馆用户服务：集成至图书馆OPAC（在线公共访问目录），为读者提供资源实时可借状态查询
• 馆员工作流支持：辅助馆员进行资源管理、借阅处理等操作，提供实时资源状态参考
• 第三方系统集成：作为服务组件，为校园门户、学习管理系统(LMS)等提供资源可用性数据

部署与配置说明

基本部署命令

Docker Run 部署

bash
docker run -d \
  --name mod-rtac \
  -p 8081:8081 \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  --memory=357913941b \
  folio/mod-rtac

Docker Compose 配置

yaml
version: '3.8'
services:
  mod-rtac:
    image: folio/mod-rtac
    container_name: mod-rtac
    ports:
      - "8081:8081"  # 模块服务端口映射
    environment:
      - JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0  # JVM内存配置
    deploy:
      resources:
        limits:
          memory: 357913941b  # 容器内存限制（约341MB）
    restart: unless-stopped

核心配置参数说明

集成注意事项

• 平台依赖：需部署于FOLIO生态环境中，确保与FOLIO服务总线（如Okapi网关）正确对接
• 网络配置：需开放8081端口，允许Okapi网关或其他集成系统访问模块服务
• 资源监控：建议结合监控工具（如Prometheus）监控模块内存使用及响应状态，确保服务稳定性

扩展配置建议

• 性能优化：根据实际资源规模调整JAVA_OPTIONS，例如通过-Xms和-Xmx参数固定堆内存大小
• 高可用部署：生产环境建议通过Kubernetes或Docker Swarm实现多实例部署，提高服务可用性
• 日志配置：可通过挂载外部日志配置文件（如log4j2.xml）自定义日志输出格式与级别