opennms/meridian-minion

Meridian Minion Docker镜像文档

1. 镜像概述

Meridian Minion 是专为 Meridian 主服务设计的轻量级辅助服务Docker镜像，作为分布式系统架构中的辅助组件，负责处理主服务委派的任务执行、跨节点数据同步及服务代理等辅助工作，旨在降低分布式环境下辅助任务的管理复杂度，提升系统整体协作效率。

2. 核心功能与特性

2.1 核心功能

• 任务执行：接收并执行Meridian主服务下发的定时或触发式任务，支持脚本执行、API调用等任务类型
• 数据同步：实现与主服务及其他Minion节点间的指定数据同步，支持增量同步与全量同步模式
• 服务代理：作为轻量级代理节点，转发主服务与其他组件间的网络请求，优化跨节点通信效率

2.2 主要特性

• 轻量级设计：基于Alpine Linux构建，镜像体积小（<50MB），资源占用低
• 配置灵活：支持通过环境变量、配置文件及API动态调整任务参数与同步策略
• 高兼容性：兼容主流容器编排平台（Kubernetes、Docker Compose）及Meridian主服务各版本
• 健康检查：内置健康检查机制，支持与主服务的心跳检测及自动恢复

3. 使用场景与适用范围

3.1 典型使用场景

• 分布式任务分发：在微服务架构中，作为任务执行节点处理主服务分发的异步任务（如日志处理、数据清洗）
• 跨地域数据同步：在多区域部署环境中，实现不同区域节点间的指定数据同步
• 服务负载分散：作为主服务的请求代理，分担主服务的网络请求压力，优化请求处理链路

3.2 适用范围

• 基于Meridian主服务构建的分布式系统
• 需要轻量化辅助任务处理的容器化环境
• 对资源占用敏感、需灵活配置的辅助服务场景

4. 使用方法与配置说明

4.1 基本使用（Docker Run）

bash
docker run -d \
  --name meridian-minion \
  -e MASTER_URL="http://meridian-master:8080" \
  -e TASK_INTERVAL=300 \
  -e LOG_LEVEL=info \
  -v /host/config:/app/config \
  meridian/minion:latest

4.2 Docker Compose配置

yaml
version: '3'
services:
  meridian-minion:
    image: meridian/minion:latest
    container_name: meridian-minion
    environment:
      - MASTER_URL="http://meridian-master:8080"  # 主服务地址
      - TASK_INTERVAL=300  # 任务轮询间隔（秒）
      - LOG_LEVEL=info  # 日志级别（debug/info/warn/error）
      - SYNC_MODE=incremental  # 数据同步模式（incremental/full）
    volumes:
      - ./minion-config:/app/config  # 挂载配置文件目录
    restart: unless-stopped

4.3 核心配置参数

4.3.1 环境变量

4.3.2 配置文件

通过挂载配置文件目录（如/app/config），可使用config.yaml自定义更详细配置：

yaml
task:
  retry_count: 3  # 任务失败重试次数
  timeout: 60     # 任务执行超时时间（秒）
sync:
  include_paths:  # 数据同步包含路径
    - /data/logs
    - /data/metrics
proxy:
  port: 8081      # 代理服务端口
  allowed_ips:    # 允许访问代理的IP列表
    - "192.168.1.0/24"

5. 健康检查与监控

容器内置健康检查接口，可通过以下方式配置Docker健康检查：

bash
docker run -d \
  --name meridian-minion \
  --health-cmd "curl -f http://localhost:8082/health || exit 1" \
  --health-interval 30s \
  --health-timeout 10s \
  --health-retries 3 \
  meridian/minion:latest

健康检查接口返回状态说明：

• 200 OK：服务正常运行
• 503 Service Unavailable：服务异常或未连接主服务

6. 注意事项

• 确保Minion节点与Meridian主服务网络互通，MASTER_URL需配置为主服务可访问地址
• 数据同步功能需挂载对应数据目录，并确保容器内有读写权限
• 生产环境建议通过配置文件自定义任务与同步策略，避免敏感信息通过环境变量暴露