folioci/mod-locations

FOLIO - mod-locations镜像

镜像概述

FOLIO平台的mod-locations模块镜像，是FOLIO图书馆服务系统的核心组件之一，专注于位置信息与服务点的管理功能，支持与系统内其他模块及外部组件（如数据库、Kafka）的协同工作。

核心功能

• 管理机构内的位置信息（如书架、部门等物理/虚拟位置）
• 维护服务点数据（如借阅台、还书处等服务节点）
• 支持FOLIO数据库连接，实现数据持久化存储
• 可选启用ECS服务点同步功能（默认关闭）
• 集成Kafka消息队列，处理位置相关的事件通知与数据同步

使用场景

• 图书馆等文化机构用于管理资源存放位置与服务节点
• FOLIO系统部署时作为位置管理模块的基础镜像
• 需要与数据库、Kafka协同的企业级位置管理场景

配置说明

元数据信息

• 容器内存限制：715827883字节
• 模块暴露端口：8081/tcp

默认环境变量

• JAVA_OPTIONS：-XX:MaxRAMPercentage=66.0（JVM内存占比配置）
• 数据库连接：需配置以下变量以启用FOLIO数据库连接：
  • 通用变量：DB_DATABASE、DB_HOST、DB_PORT、DB_USERNAME、DB_PASSWORD、DB_CHARSET
  • 高级变量：
    • DB_CONNECTIONRELEASEDELAY：默认60000毫秒（连接释放延迟）
    • DB_MAXPOOLSIZE：默认5（最大连接池大小）
    • DB_MAXSHAREDPOOLSIZE：默认3（最大共享连接池大小）
    • DB_QUERYTIMEOUT：默认60000毫秒（查询超时时间）
• ECS同步开关：ECS_SERVICE_POINT_SYNC_FEATURE_ENABLED（默认false）
• Kafka配置：
  • KAFKA_HOST：默认kafka（Kafka服务地址）
  • KAFKA_PORT：默认9092（Kafka端口）
  • 主题分区数：各位置相关主题默认1个分区
  • REPLICATION_FACTOR：默认1（消息副本因子）

部署示例

Docker Run命令

bash
docker run -d \
  --name mod-locations \
  -p 8081:8081 \
  -e DB_HOST=your-postgres-host \
  -e DB_PORT=5432 \
  -e DB_DATABASE=folio_db \
  -e DB_USERNAME=folio_user \
  -e DB_PASSWORD=your-db-password \
  -e KAFKA_HOST=your-kafka-host \
  folioci/mod-locations

Docker Compose示例

yaml
version: '3.8'
services:
  mod-locations:
    image: folioci/mod-locations
    ports:
      - "8081:8081"
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_DATABASE=folio
      - DB_USERNAME=folio
      - DB_PASSWORD=folio_pass
      - KAFKA_HOST=kafka
      - KAFKA_PORT=9092
    depends_on:
      - postgres
      - kafka

  postgres:
    image: postgres:14-alpine
    environment:
      - POSTGRES_DB=folio
      - POSTGRES_USER=folio
      - POSTGRES_PASSWORD=folio_pass
    volumes:
      - postgres_data:/var/lib/postgresql/data

  kafka:
    image: confluentinc/cp-kafka:7.4.0
    environment:
      - KAFKA_BROKER_ID=1
      - KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka:9092
      - KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1
    depends_on:
      - zookeeper

  zookeeper:
    image: confluentinc/cp-zookeeper:7.4.0
    environment:
      - ZOOKEEPER_CLIENT_PORT=2181
      - ZOOKEEPER_TICK_TIME=2000

volumes:
  postgres_data: