folioci/mod-invoice-storage

FOLIO - mod-invoice-storage

镜像概述

mod-invoice-storage是FOLIO项目的核心模块之一，主要功能为发票数据的持久化存储，确保发票信息在FOLIO生态系统中稳定保存和高效访问。
代码仓库：https://github.com/folio-org/mod-invoice-storage

核心功能

• 提供发票数据的持久化存储能力，支持FOLIO系统中发票信息的长期管理。

使用场景

适用于FOLIO生态系统中需要处理、存储和管理发票数据的应用环境，如图书馆、学术机构等使用FOLIO进行资源管理的组织。

元数据信息

• 模块端口：8081（容器内服务监听端口）
• 容器内存需求：357913941字节（约341MB）
• 数据库连接：需连接数据库（模块依赖数据库实现数据持久化）
• JAVA_OPTIONS：-XX:MaxRAMPercentage=66.0（JVM内存配置，控制最大内存占比）
• 环境变量：
  • KAFKA_HOST：Kafka服务主机地址（默认值：10.0.2.15）
  • KAFKA_PORT：Kafka服务端口（默认值：9092）

使用方法

基本部署命令

通过docker run部署时，需配置端口映射、环境变量及数据库连接参数：

bash
docker run -d \
  -p 8081:8081 \
  -e KAFKA_HOST=<your-kafka-host> \
  -e KAFKA_PORT=<your-kafka-port> \
  -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> \
  --memory=341m \
  folio/mod-invoice-storage

配置说明

端口映射

需将容器内8081端口映射至主机端口，确保外部服务可访问模块接口，格式：-p <主机端口>:8081。

环境变量配置

• Kafka连接：KAFKA_HOST和KAFKA_PORT用于指定模块与Kafka消息系统的通信地址，需根据实际Kafka部署环境调整。
• 数据库连接：需配置数据库相关环境变量（如DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASSWORD等），确保模块能连接数据库完成数据持久化（具体参数需根据数据库类型和部署环境确定）。

资源限制

• 内存：建议容器内存限制设置为341MB（357913941字节），以满足模块运行需求。
• JVM配置：默认通过JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0控制JVM内存占比，可根据容器内存调整该参数。