Dragonfly集群管理工具Docker镜像文档

1. 镜像概述和主要用途

本镜像提供Dragonfly分布式存储集群的一站式管理能力，集成集群部署、配置管理、状态监控、故障诊断及日常运维功能。通过容器化方式简化管理工具的部署与环境依赖，适用于Dragonfly集群从开发测试到生产环境的全生命周期管理场景。

2. 核心功能和特性

2.1 集群部署与初始化

• 支持多节点集群自动部署，自动识别节点角色（主节点/从节点）
• 内置集群初始化向导，生成基础配置模板（副本策略、网络参数、存储路径等）

2.2 日常运维管理

• 节点生命周期管理：添加/移除节点、角色切换（主从切换）、状态标记（维护/在线）
• 配置动态更新：支持集群级/节点级配置热更新（无需重启集群）
• 数据操作：副本迁移调度、数据均衡、容量预警与自动扩容触发

2.3 监控与诊断

• 实时集群状态监控：节点健康度、存储容量、IO性能、网络延迟指标可视化
• 日志集中管理：支持节点日志聚合查询、关键字检索及异常日志告警
• 故障诊断工具：自动检测网络分区、数据不一致、节点离线等异常，提供修复建议

2.4 安全与审计

• 基于RBAC的权限控制，支持管理员/运维/只读等角色划分
• 操作审计日志：记录集群配置变更、节点操作等关键行为，支持审计追溯

3. 使用场景和适用范围

3.1 典型使用场景

• 开发测试环境：快速搭建多节点Dragonfly集群，模拟生产环境配置验证
• 生产环境运维：日常节点扩容/缩容、配置优化、版本升级
• 故障处理：节点离线恢复、数据副本修复、网络故障诊断
• 容量规划：监控集群存储增长趋势，触发扩容策略
• 合规审计：记录集群操作日志，满足数据安全合规要求

3.2 适用范围

• 使用Dragonfly作为分布式存储的企业级应用集群
• 需要对Dragonfly集群进行自动化管理的运维团队
• 需跨环境（开发/测试/生产）统一管理工具链的场景

4. 使用方法和配置说明

4.1 拉取镜像

bash
docker pull dragonfly/cluster-manager:latest

4.2 基本运行命令

通过容器内管理工具连接目标集群，执行基础运维操作：

bash
docker run -it --rm \
  -e DRAGONFLY_MASTER_ADDR=192.168.1.100:6379 \  # 集群主节点地址（必填）
  -e ADMIN_PORT=8080 \                           # 管理API端口（默认8080）
  -e LOG_LEVEL=info \                            # 日志级别（默认info）
  dragonfly/cluster-manager:latest \
  clusterctl status  # 查看集群状态示例命令

4.3 配置文件挂载

如需自定义集群管理策略（如扩容阈值、告警规则），可挂载本地配置文件：

bash
docker run -it --rm \
  -e DRAGONFLY_MASTER_ADDR=192.168.1.100:6379 \
  -v /local/path/config.yaml:/etc/dragonfly/cluster-manager/config.yaml \  # 挂载自定义配置
  -v /var/log/dragonfly-manager:/var/log/dragonfly-manager \              # 挂载日志目录
  dragonfly/cluster-manager:latest

5. Docker部署方案示例

5.1 单节点管理容器（docker run）

bash
docker run -d \
  --name dragonfly-manager \
  --network host \  # 如需直接访问主机网络的Dragonfly节点，可使用host网络
  -e DRAGONFLY_MASTER_ADDR=10.0.0.10:6379 \  # Dragonfly主节点地址（必填）
  -e ADMIN_PORT=8080 \                       # 管理API端口（默认8080）
  -e LOG_LEVEL=debug \                       # 调试模式日志级别
  -e RBAC_ENABLE=true \                      # 启用RBAC权限控制
  -v /etc/dragonfly-manager:/etc/config \    # 挂载配置目录（含rbac.yaml）
  -v /var/log/dragonfly-manager:/var/log \   # 挂载日志目录
  -v /var/run/docker.sock:/var/run/docker.sock \  # 如需管理容器化Dragonfly节点
  dragonfly/cluster-manager:latest

5.2 多节点集群管理（docker-compose）

yaml
version: '3.8'
services:
  dragonfly-manager:
    image: dragonfly/cluster-manager:latest
    container_name: dragonfly-manager
    restart: always
    ports:
      - "8080:8080"  # 管理API端口映射
      - "9090:9090"  # 监控指标端口（Prometheus）
    environment:
      - DRAGONFLY_MASTER_ADDR=10.0.0.10:6379
      - ADMIN_PORT=8080
      - LOG_LEVEL=info
      - RBAC_ENABLE=true
      - METRICS_PORT=9090
    volumes:
      - ./config:/etc/config  # 本地配置目录（含集群策略、RBAC规则）
      - ./logs:/var/log       # 日志持久化
      - /var/run/docker.sock:/var/run/docker.sock  # Docker节点管理权限
    networks:
      - dragonfly-net  # 与Dragonfly集群共享网络

networks:
  dragonfly-net:
    driver: bridge
    ipam:
      config:
        - subnet: 10.0.1.0/24  # 与Dragonfly集群同网段

6. 配置参数说明

6.1 核心环境变量

6.2 配置文件说明

默认配置文件路径为 /etc/config/cluster.yaml，支持自定义集群策略（如副本数、数据均衡阈值、扩容触发条件等），示例配置片段：

yaml
cluster:
  replication:
    default_replicas: 3  # 默认副本数
    min_available_replicas: 2  # 最小可用副本数阈值
  balance:
    disk_usage_threshold: 85  # 磁盘使用率超过85%触发均衡
    network_bandwidth_limit: 100MB/s  # 数据迁移带宽限制
  scale:
    auto_scale: true  # 启用自动扩容
    min_nodes: 3      # 最小节点数
    max_nodes: 10     # 最大节点数

7. 常用操作命令

容器运行后，可通过 docker exec 进入容器执行管理命令：

bash
# 查看集群状态
docker exec -it dragonfly-manager clusterctl status

# 添加新节点
docker exec -it dragonfly-manager clusterctl node add --addr 10.0.0.11:6379 --role slave

# 查看节点日志
docker exec -it dragonfly-manager clusterctl log --node 10.0.0.10:6379 --tail 100

# 触发数据均衡
docker exec -it dragonfly-manager clusterctl balance start