folioorg/edge-patron

FOLIO - edge-patron 镜像文档

镜像概述

edge-patron是FOLIO项目提供的服务镜像，用于运行FOLIO平台的边缘层用户相关服务。该镜像无需数据库连接，默认配置固定端口和内存资源，可通过环境变量调整运行参数。代码仓库：https://github.com/folio-org/edge-patron%E3%80%82

核心功能与特性

• 模块端口：固定使用8081端口提供服务
• 容器内存：默认分配256MB（268435456字节）运行内存
• 数据库依赖：无需数据库连接（Database connection: false）
• Java配置：通过JAVA_OPTIONS设置JVM参数-XX:MaxRAMPercentage=66.0，限制JVM最大内存占比
• 环境变量：支持配置安全请求特性开关（SECURE_REQUESTS_FEATURE_ENABLED）和安全租户ID（SECURE_TENANT_ID）

使用场景

适用于FOLIO图书馆服务平台的边缘层部署，作为用户请求处理的基础组件，与其他FOLIO服务协同提供用户相关功能支持。

使用方法与配置说明

基本运行命令

通过docker run启动容器，映射8081端口并配置必要环境变量：

bash
docker run -d \
  -p 8081:8081 \
  -e "JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0" \
  -e "SECURE_REQUESTS_FEATURE_ENABLED=false" \
  -e "SECURE_TENANT_ID=securetenant" \
  --memory=256m \
  folio/edge-patron

Docker Compose配置示例

在docker-compose.yml中定义服务：

yaml
version: '3'
services:
  edge-patron:
    image: folio/edge-patron
    ports:
      - "8081:8081"
    environment:
      - JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0
      - SECURE_REQUESTS_FEATURE_ENABLED=false
      - SECURE_TENANT_ID=securetenant
    deploy:
      resources:
        limits:
          memory: 256M

环境变量说明

资源限制建议

容器运行时需保证至少256MB可用内存，建议通过--memory=256m（docker run）或deploy.resources.limits.memory（docker-compose）显式设置内存限制，避免资源竞争。