openlmis/diagnostics

OpenLMIS Health & Information Service Docker镜像文档

1. 镜像概述和主要用途

OpenLMIS Health & Information Service是OpenLMIS(开源***物流管理信息系统)的核心组件之一，专注于提供健康数据收集、处理和信息服务功能。该Docker镜像封装了完整的服务运行环境，便于快速部署和集成到OpenLMIS生态系统中。

主要用途包括：***资源监控数据聚合、健康指标追踪、信息报告生成以及与其他OpenLMIS服务的数据交互。

2. 核心功能和特性

• 健康数据采集与标准化处理
• 实时***资源状态监控
• 自定义报表生成与导出
• 多维度数据分析与可视化
• 与OpenLMIS其他模块的无缝集成
• 符合HL7等***数据交换标准
• 基于角色的访问控制
• 完整的审计日志功能

3. 使用场景和适用范围

适用场景

• ***供应链管理中的数据监控中心
• 公共卫生信息收集与分析系统
• ***资源分配决策支持系统
• 区域***物流协调平台
• ***库存与消耗趋势分析

适用范围

• 各级***机构后勤管理部门
• 公共卫生管理机构
• ***供应链相关企业
• 非******援助组织
• ***资源监管机构

4. 快速开始

4.1 Docker Run命令示例

bash
docker run -d \
  --name openlmis-health-service \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=production \
  -e DB_HOST=db.example.com \
  -e DB_NAME=openlmis_health \
  -e DB_USERNAME=dbuser \
  -e DB_PASSWORD=dbpass \
  -e OPENLMIS_AUTH_SERVER_URL=http://auth-service:8080 \
  -v openlmis-health-data:/var/lib/openlmis/health \
  openlmis/health-information-service:latest

4.2 Docker Compose配置示例

yaml
version: '3.8'

services:
  health-service:
    image: openlmis/health-information-service:latest
    container_name: openlmis-health-service
    restart: always
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=production
      - SERVER_PORT=8080
      - DB_HOST=db
      - DB_PORT=5432
      - DB_NAME=openlmis_health
      - DB_USERNAME=postgres
      - DB_PASSWORD=securepassword
      - OPENLMIS_AUTH_SERVER_URL=http://auth-service:8080
      - LOGGING_LEVEL_ROOT=INFO
      - CACHE_TTL=3600
    volumes:
      - health-data:/var/lib/openlmis/health
      - ./config:/etc/openlmis/health
    depends_on:
      - db
    networks:
      - openlmis-network
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  db:
    image: postgres:13
    container_name: openlmis-health-db
    restart: always
    environment:
      - POSTGRES_DB=openlmis_health
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=securepassword
    volumes:
      - postgres-data:/var/lib/postgresql/data
    networks:
      - openlmis-network

volumes:
  health-data:
  postgres-data:

networks:
  openlmis-network:
    driver: bridge

5. 详细配置说明

5.1 环境变量配置

5.2 配置文件挂载

服务支持通过外部配置文件进行高级配置，可通过挂载配置目录实现：

bash
-v ./custom-config:/etc/openlmis/health/config

配置文件结构:

custom-config/
├── application.yml          # 主配置文件
├── application-production.yml # 生产环境配置
├── logback.xml              # 日志配置
└── report-templates/        # 报表模板目录

5.3 数据持久化

建议为以下目录创建持久卷:

• /var/lib/openlmis/health - 服务数据存储目录
• /var/log/openlmis - 日志存储目录

6. 网络配置

6.1 端口映射

默认情况下，服务监听容器内8080端口，可通过-p参数映射到主机端口:

bash
-p 8080:8080  # 将容器8080端口映射到主机8080端口

6.2 服务发现

若使用服务发现机制，可配置:

bash
-e EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://discovery-server:8761/eureka/

6.3 CORS配置

通过环境变量配置CORS:

bash
-e CORS_ALLOWED_ORIGINS=https://example.com,https://admin.example.com
-e CORS_ALLOWED_METHODS=GET,POST,PUT,DELETE
-e CORS_ALLOWED_HEADERS=Content-Type,Authorization

7. 健康检查

服务内置健康检查端点，可通过以下方式配置Docker健康检查:

bash
--health-cmd "curl -f http://localhost:8080/actuator/health || exit 1" \
--health-interval 30s \
--health-timeout 10s \
--health-retries 3

健康检查端点: /actuator/health

完整健康信息(需认证): /actuator/health/detail

8. 日志管理

8.1 日志级别配置

通过环境变量设置不同组件的日志级别:

bash
-e LOGGING_LEVEL_ROOT=INFO \
-e LOGGING_LEVEL_ORG_OPENLMIS=DEBUG \
-e LOGGING_LEVEL_ORG_HIBERNATE=WARN

8.2 日志输出

默认日志输出到标准输出和文件，文件日志位于/var/log/openlmis/health-service.log。

要配置日志轮转，可挂载自定义logback配置:

bash
-v ./logback.xml:/etc/openlmis/health/logback.xml

9. 常见问题排查

9.1 数据库连接问题

症状: 服务启动失败，日志中出现数据库连接错误。

解决方法:

• 验证数据库主机、端口、用户名和密码是否正确
• 确保数据库服务正在运行且可从容器访问
• 检查数据库用户权限

9.2 认证失败

症状: 无法访问服务API，返回401或403错误。

解决方法:

• 验证认证服务器URL配置是否正确
• 检查服务令牌是否有效
• 确认服务账户具有适当权限

9.3 报表生成失败

症状: 报表生成请求失败或生成的报表为空。

解决方法:

• 检查报表模板是否存在且格式正确
• 验证数据源连接
• 检查是否有足够的磁盘空间用于生成报表

9.4 性能问题

症状: 服务响应缓慢，处理时间长。

解决方法:

• 调整JVM内存配置: -e JAVA_OPTS="-Xms512m -Xmx1g"
• 优化数据库连接池: 通过配置文件调整连接池参数
• 检查系统资源使用情况，确保CPU和内存充足

10. 版本更新

更新服务到最新版本:

bash
# 停止并删除当前容器
docker stop openlmis-health-service
docker rm openlmis-health-service

# 拉取最新镜像
docker pull openlmis/health-information-service:latest

# 使用原配置重新启动
docker run [原有参数] openlmis/health-information-service:latest

注意: 版本更新前建议备份数据卷和配置文件，重大版本更新可能需要数据库迁移。