Collectorset Controller 镜像文档

镜像概述

本镜像为Collectorset Controller的官方镜像，用于提供Collectorset的集中化管理能力。Collectorset Controller是一款用于管理数据收集集群（Collectorset）的控制器工具，支持Collectorset的创建、配置、部署、运行状态监控及全生命周期管理，适用于需要统一管理多节点、多任务数据收集场景的系统。

核心功能与特性

• Collectorset全生命周期管理：支持Collectorset的创建、更新、删除及运行状态控制，实现数据收集集群的自动化管理。
• 配置集中化管理：提供Collectorset配置文件的统一存储、分发与版本控制，支持动态配置更新。
• 部署控制：支持基于规则的Collectorset自动部署与扩缩容，适配不同规模的数据收集需求。
• 状态监控：实时监控Collectorset节点运行状态、数据收集任务进度及资源占用情况，提供异常告警能力。
• 兼容性支持：兼容主流数据收集工具（如Prometheus、Fluentd等）的Collectorset配置格式。

使用场景

• 企业级数据收集平台：用于管理跨部门、跨业务线的分布式数据收集任务，实现数据采集的标准化与集中化。
• 监控系统数据采集：在监控平台中管理各类监控指标的Collectorset，确保数据采集任务的稳定运行与灵活调整。
• 日志/ metrics数据整合：统一管理日志收集、指标采集等不同类型的Collectorset，简化多源数据整合流程。

使用方法与配置说明

前提条件

• Docker引擎版本≥19.03
• 若需持久化配置，需准备本地配置目录（如/opt/collectorset-controller/config）
• 若启用数据库存储，需提前部署支持的数据库（如MySQL、PostgreSQL）

镜像拉取

docker pull repository/collectorset-controller:latest

基本运行示例

docker run -d \
  --name collectorset-controller \
  -p 8080:8080 \  # 控制器API端口映射
  -v /opt/collectorset-controller/config:/etc/collectorset-controller \  # 挂载配置目录
  -v /opt/collectorset-controller/data:/var/lib/collectorset-controller \  # 挂载数据存储目录
  -e CONTROLLER_PORT=8080 \  # 控制器服务端口
  -e LOG_LEVEL=info \  # 日志级别（debug/info/warn/error）
  repository/collectorset-controller:latest

环境变量配置

配置文件说明

控制器配置文件默认路径为容器内/etc/collectorset-controller/config.yaml，挂载本地目录后可通过修改该文件自定义配置。核心配置项示例：

# 控制器基本配置
controller:
  port: ${CONTROLLER_PORT}  # 优先级：环境变量 > 配置文件
  log_level: ${LOG_LEVEL}
  max_concurrent_tasks: 100  # 最大并发任务数

# Collectorset默认配置模板
collectorset:
  default_image: "repository/collector:latest"  # 默认收集器镜像
  resource_limits:
    cpu: "1"
    memory: "1Gi"

验证运行状态

启动容器后，可通过以下命令检查运行状态：

# 查看容器日志
docker logs -f collectorset-controller

# 访问控制器API验证服务可用性
curl http://localhost:8080/api/v1/health
# 预期返回：{"status": "healthy", "version": "x.y.z"}