chimefrb/frb-master

CHIME/FRB Monitor and Control Master Docker镜像文档

1. 镜像概述

本Docker镜像专为CHIME（Canadian Hydrogen Intensity Mapping Experiment）/FRB（Fast Radio Burst）项目设计，作为监控与控制主节点（Monitor and Control Master），负责协调和管理CHIME/FRB射电望远镜系统的各个组件，确保FRB探测系统的稳定运行和高效数据处理。

2. 核心功能与特性

2.1 核心功能

• 实时监控CHIME/FRB系统各组件（天线阵列、信号处理器、数据存储单元等）的运行状态
• 集中化数据采集与处理，整合系统关键指标（温度、电压、数据流量、处理延迟等）
• 支持设备远程控制操作，包括参数配置、组件启停及故障恢复
• 系统日志记录与异常告警，实时反馈故障信息并触发告警机制
• 与CHIME/FRB数据处理 pipeline 无缝集成，确保数据流转与处理的协调性

2.2 主要特性

• 轻量化设计：基于Alpine Linux构建，容器体积小，资源占用低
• 模块化架构：支持功能组件按需扩展，适配不同实验需求
• 标准化接口：内置REST API接口，便于与外部监控系统集成
• 高可用性：支持多节点部署模式，避免单点故障
• 协议兼容：兼容CHIME/FRB项目标准通信协议（如gRPC、MQTT）

3. 使用场景与适用范围

3.1 主要使用场景

• CHIME/FRB射电望远镜实验设施的日常运维监控
• FRB探测过程中的实时数据状态跟踪与质量评估
• 系统故障诊断与远程修复操作
• 多组件协同工作的集中化管理与调度
• 实验数据采集与处理流程的实时协调控制

3.2 适用范围

• CHIME/FRB项目科研团队及系统运维人员
• 射电天文观测设施中类似分布式系统的监控与控制场景
• 需要集中化管理远程设备集群的科研实验环境

4. 使用方法与配置说明

4.1 基本启动命令

bash
docker run -d \
  --name chime-frb-monitor-master \
  --network=host \
  -p 8080:8080 \
  -v /local/config:/app/config \
  -v /local/logs:/app/logs \
  -e CONTROL_API_PORT=8080 \
  -e MONITOR_INTERVAL=5 \
  -e LOG_LEVEL=INFO \
  -e DB_HOST=192.168.1.100 \
  chimefrb/monitor-control-master:latest

4.2 环境变量配置

4.3 数据卷挂载要求

4.4 服务状态验证

容器启动后，可通过以下方式验证服务状态：

• 健康检查端点：http://<容器IP>:<CONTROL_API_PORT>/health，返回 {"status": "healthy"} 表示服务正常
• 日志验证：查看 /app/logs/main.log，确认无启动错误日志
• API验证：使用 curl http://<容器IP>:8080/api/v1/components 获取已连接组件列表

5. 部署建议

• 生产环境建议使用 docker-compose 编排，配合PostgreSQL数据库、Prometheus监控等组件部署
• 配置文件需根据实际硬件拓扑修改 components.yaml 中的组件IP与端口信息
• 高可用性部署时，建议使用负载均衡器分发API请求，避免单节点压力过大
• 定期备份 /app/config 目录下的配置文件，防止配置丢失导致服务不可用