folioci/mod-linked-data

mod-linked-data 镜像文档

镜像概述

mod-linked-data是FOLIO图书馆系统的核心模块之一，主要用于管理图书馆目录的数据图，支持数据关联与处理。该模块集成了数据库连接与Kafka消息系统，实现对源记录和库存实例事件的处理，确保目录数据的一致性与可用性。

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

核心功能与特性

• 数据图管理：核心功能为管理FOLIO图书馆目录的数据图，维护数据间关联关系
• 数据库依赖：需配置数据库连接以存储和访问数据
• Kafka集成：支持Kafka事件处理，包括源记录域事件、库存实例事件的消费与处理
• 资源配置：默认占用内存1GB（***字节），服务端口8081
• JVM优化：通过JAVA_OPTIONS配置JVM参数，设置最大RAM使用率85%、线程栈大小4m
• 缓存控制：提供缓存过期时间配置（CACHE_TTL_*系列变量），默认缓存时间为5小时（***毫秒）

使用场景

适用于FOLIO图书馆系统环境中，需管理目录数据关联、处理源记录变更事件、同步库存实例数据的场景，支持图书馆目录数据图的构建、维护与事件驱动的数据更新。

使用方法与配置说明

基础信息

• 模块端口：8081
• 默认内存限制：***字节（1GB）
• 数据库依赖：需配置数据库连接
• JVM参数：-XX:MaxRAMPercentage=85.0 -Xss4m

环境变量配置

Docker部署示例

1. docker run 命令示例

bash
docker run -d \
  --name mod-linked-data \
  -p 8081:8081 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_HOST=postgres \
  -e DB_PORT=5432 \
  -e DB_NAME=folio \
  -e DB_USER=folio_user \
  -e DB_PASSWORD=folio_password \
  -e KAFKA_HOST=kafka \
  -e KAFKA_PORT=9092 \
  docker.xuanyuan.run/folioorg/mod-linked-data:latest

2. docker-compose 配置示例

yaml
version: '3.8'

services:
  mod-linked-data:
    image: docker.xuanyuan.run/folioorg/mod-linked-data:latest
    container_name: mod-linked-data
    ports:
      - "8081:8081"
    environment:
      - SERVER_PORT=8081
      - ENV=folio
      - SPRING_PROFILES_ACTIVE=prod
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=folio
      - DB_USER=folio_user
      - DB_PASSWORD=folio_password
      - KAFKA_HOST=kafka
      - KAFKA_PORT=9092
      - KAFKA_SECURITY_PROTOCOL=PLAINTEXT
      - KAFKA_CONSUMER_MAX_POLL_RECORDS=200
      - CACHE_TTL_SPEC_RULES_MS=18000000
    depends_on:
      - postgres
      - kafka
    restart: unless-stopped

  postgres:
    image: docker.xuanyuan.run/postgres:13
    environment:
      - POSTGRES_DB=folio
      - POSTGRES_USER=folio_user
      - POSTGRES_PASSWORD=folio_password
    ports:
      - "5432:5432"

  kafka:
    image: docker.xuanyuan.run/confluentinc/cp-kafka:7.3.0
    environment:
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka:9092
      - KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1
      - KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181
    depends_on:
      - zookeeper

  zookeeper:
    image: docker.xuanyuan.run/confluentinc/cp-zookeeper:7.3.0
    environment:
      - ZOOKEEPER_CLIENT_PORT=2181

注：实际部署时需根据环境调整数据库、Kafka等依赖服务的配置参数。