RuBAN平台KairosDB微服务镜像文档

1. 镜像概述

本镜像为RuBAN平台设计，是运行KairosDB时序数据库的专用微服务组件。KairosDB是一款针对时序数据优化的开源数据库，本镜像封装了其核心功能与运行依赖，提供开箱即用的时序数据管理能力，无缝集成于RuBAN平台架构，支持高吞吐量数据写入与低延迟查询。

2. 核心功能和特性

• 高效时序数据处理：针对时间序列数据（如监控指标、传感器读数）优化的存储引擎，支持每秒数十万级数据点写入。
• 多存储后端兼容：默认适配Cassandra分布式存储，可扩展支持HBase、Elasticsearch等存储系统。
• 标准化API接口：提供RESTful API与Telnet协议接口，支持数据写入、查询、删除及元数据管理操作。
• 微服务架构优化：轻量级容器封装，支持水平扩展，可通过RuBAN平台服务发现机制实现动态集群部署。
• 灵活配置能力：支持通过环境变量或配置文件自定义存储策略、数据保留规则及网络参数。

3. 使用场景和适用范围

本镜像适用于RuBAN平台环境下的时序数据管理场景，包括但不限于：

• 服务器、网络设备及应用程序的监控指标存储与分析
• 物联网传感器、工业设备产生的时序数据实时 ingestion
• 日志数据、用户行为数据等时间序列数据的结构化存储
• 业务指标（如交易频次、访问量）的历史趋势分析与可视化

4. 使用方法和配置说明

4.1 基本运行命令

通过以下命令快速启动服务：

docker run -d \
  --name ruban-kairosdb \
  -p 8080:8080 \
  -e CASSANDRA_HOSTS=cassandra-node1:9042,cassandra-node2:9042 \
  -e DATA_RETENTION_POLICY=7d \
  ruban/kairosdb-microservice:latest

4.2 环境变量配置

4.3 Docker Compose配置示例

在RuBAN平台中推荐使用Docker Compose进行服务编排：

version: '3.8'
services:
  kairosdb:
    image: ruban/kairosdb-microservice:latest
    container_name: ruban-kairosdb
    ports:
      - "8080:8080"
    environment:
      - CASSANDRA_HOSTS=cassandra:9042
      - DATA_RETENTION_POLICY=14d
      - LOG_LEVEL=WARN
    depends_on:
      - cassandra
    networks:
      - ruban-service-net
    restart: unless-stopped

  cassandra:
    image: cassandra:3.11
    container_name: ruban-cassandra
    ports:
      - "9042:9042"
    volumes:
      - cassandra-data:/var/lib/cassandra
    networks:
      - ruban-service-net
    environment:
      - CASSANDRA_CLUSTER_NAME=ruban-kairosdb-cluster

networks:
  ruban-service-net:
    driver: overlay

volumes:
  cassandra-data:

4.4 数据持久化说明

KairosDB本身不存储原始数据，需确保后端存储（如Cassandra）配置数据卷以实现持久化。建议通过RuBAN平台存储服务提供的分布式存储卷挂载至后端数据库容器。