folioorg/mod-invoice-storage

FOLIO - mod-invoice-storage

镜像概述

mod-invoice-storage是FOLIO项目的核心模块之一，专注于发票数据的持久化存储，确保发票信息的可靠保存、管理与访问。该模块为FOLIO生态系统中的发票相关业务提供数据存储支撑。

代码仓库：https://github.com/folio-org/mod-invoice-storage

核心功能与特性

• 持久化存储：提供发票数据的长期、稳定存储能力，保障数据不丢失。
• 数据库连接：需与数据库建立连接以实现数据持久化，确保数据的结构化存储和高效查询。
• Kafka集成：支持通过环境变量配置Kafka连接信息，实现与Kafka消息系统的集成。
• 模块端口：默认模块端口为8081，用于服务通信。
• JVM配置：通过JAVA_OPTIONS设置JVM参数，默认值为-XX:MaxRAMPercentage=66.0，优化内存使用。
• 容器内存限制：容器内存限制为357913941字节（约341.3MB）。

使用场景

适用于FOLIO生态系统中需要处理、存储和管理发票数据的应用场景，如图书馆管理系统、财务系统等涉及发票信息录入、查询和归档的业务模块。

使用方法与配置说明

环境变量配置

Docker部署示例

基本运行命令

bash
docker run -d \
  --name mod-invoice-storage \
  -p 8081:8081 \
  -e KAFKA_HOST=10.0.2.15 \
  -e KAFKA_PORT=9092 \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  -e DB_HOST=your-db-host \
  -e DB_PORT=your-db-port \
  -e DB_NAME=your-db-name \
  -e DB_USER=your-db-user \
  -e DB_PASSWORD=your-db-password \
  folio/mod-invoice-storage

说明

• -p 8081:8081：映射容器端口8081到主机，确保服务可访问。
• 数据库相关环境变量（DB_HOST等）需根据实际数据库环境进行配置，以建立正确的数据库连接。
• KAFKA_HOST和KAFKA_PORT需根据Kafka服务的实际部署地址进行调整。

注意事项

• 需确保数据库服务已启动并可被容器访问，数据库连接参数配置正确。
• 根据实际需求调整JAVA_OPTIONS中的JVM参数，以优化性能。
• 容器内存使用不得超过357913941字节，避免内存溢出。