folioorg/mod-template-engine

FOLIO - mod-template-engine

镜像概述

mod-template-engine是FOLIO（图书馆开放源码基础设施）项目的模板引擎模块，主要功能为存储模板并使用模板生成文件。该模块是FOLIO生态系统的一部分，用于支持平台中的文件自动化生成需求。

代码仓库：https://github.com/folio-org/mod-template-engine

核心功能与特性

• 模板存储：提供模板的持久化存储与管理功能
• 文件生成：基于存储的模板动态生成文件

元数据与配置说明

基础元数据

• 模块端口：8081（容器内服务监听端口）
• 容器内存：357913941字节（约341MB，建议容器内存配置不低于此值）
• 数据库依赖：需要数据库连接（需配置数据库访问参数）
• Java虚拟机参数：-XX:MaxRAMPercentage=66.0（控制JVM内存使用比例）

必要配置项

• 数据库连接：需通过环境变量配置数据库URL、用户名、密码等连接信息（具体参数需参考项目文档）
• 端口映射：部署时需将容器8081端口映射至主机端口以提供外部访问

适用场景

适用于FOLIO平台中需要通过模板动态生成文件的业务场景，如报告生成、通知单自动化、批量文档处理等。

部署与使用示例

Docker Run部署命令

bash
docker run -d \
  --name folio-mod-template-engine \
  -p 8081:8081 \
  -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> \
  --memory=357913941b \
  folioorg/mod-template-engine

命令说明

• -p 8081:8081：将主机端口映射至容器服务端口
• --memory=357913941b：设置容器内存限制（对应元数据要求）
• 环境变量JAVA_OPTIONS：固定配置为元数据中指定的JVM参数
• 数据库相关环境变量（DB_HOST等）：需根据实际数据库环境替换占位符值

注意事项

• 需确保数据库服务已提前部署并可被容器访问
• 内存配置建议遵循元数据指定的357913941字节，避免因内存不足导致服务异常
• 详细API使用方法及模板管理操作需参考项目官方文档