camptocamp/mapfish-print-logs

共享打印日志访问微服务镜像

镜像概述和主要用途

本镜像是一个轻量级微服务，旨在为客户提供便捷访问共享打印日志的功能。通过标准化接口简化客户获取打印日志的流程，支持集中化日志管理与客户访问需求，适用于需要共享打印资源并提供日志查询能力的场景。

核心功能和特性

• 客户访问控制：支持对客户访问权限的基础管理，确保日志访问安全性
• 共享日志查询：提供统一接口供客户查询共享打印日志，支持基础筛选功能
• 轻量级部署：基于容器化设计，资源占用低，部署便捷
• 跨平台兼容：支持主流Linux发行版及Docker环境，具备良好的可移植性
• 日志集成能力：可与常见日志存储系统（如本地文件、共享存储）集成

使用场景和适用范围

• 企业多部门共享打印：企业内部多团队/部门共用打印设备时，各部门客户需独立查询本团队打印日志的场景
• 客户自助日志查询：需为外部客户或合作伙伴提供打印日志自助查询接口的场景
• 集中化打印日志管理：需要统一管理打印日志并对外提供标准化访问服务的场景
• 轻量化日志服务部署：资源受限环境下需快速部署日志访问服务的场景

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name print-log-service \
  -p 8080:8080 \
  -v /path/to/shared-logs:/app/logs \
  -e PORT=8080 \
  -e LOG_PATH=/app/logs \
  your-registry/print-log-service:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  print-log-service:
    image: your-registry/print-log-service:latest
    container_name: print-log-service
    ports:
      - "8080:8080"
    volumes:
      - ./shared-print-logs:/app/logs
    environment:
      - PORT=8080
      - LOG_PATH=/app/logs
      - AUTH_ENABLED=false  # 是否启用访问认证（默认false）
      - LOG_RETENTION_DAYS=30  # 日志保留天数（默认30天）
    restart: unless-stopped

配置参数说明

访问接口示例

服务启动后，可通过以下HTTP接口访问打印日志（具体接口取决于服务实现，此处为通用示例）：

• 查询日志列表：GET http://localhost:8080/api/logs
• 查询特定日志详情：GET http://localhost:8080/api/logs/{logId}
• 筛选日志（按时间范围）：GET http://localhost:8080/api/logs?startDate=2024-01-01&endDate=2024-01-31

注意事项

• 确保挂载的日志目录具有正确的读写权限，避免服务无法访问日志文件
• 启用认证（AUTH_ENABLED=true）时，需额外配置认证相关参数（如API密钥、用户凭证等）
• 生产环境建议配合反向代理（如Nginx）使用，以增强安全性和负载能力