Kuboard v3.0 集群端 Agent 镜像文档

镜像概述

本镜像为Kuboard v3.0版本的集群端Agent组件，用于在多集群管理场景中，作为Kuboard控制平面与目标Kubernetes集群之间的通信中介，实现控制平面对多集群的统一管理与资源交互。

主要用途

• 建立Kuboard控制平面与目标集群的安全通信通道
• 收集目标集群的资源信息并同步至控制平面
• 执行控制平面下发的集群管理操作指令
• 支撑多集群环境下的统一监控、配置与运维

核心功能与特性

通信与数据同步

• 与Kuboard控制平面维持长连接，支持双向通信
• 周期性同步目标集群的节点、Pod、Deployment等核心资源元数据
• 实时上报集群事件与状态变化

操作执行能力

• 接收并执行控制平面下发的资源创建、更新、删除操作
• 支持集群级操作（如命名空间管理、资源配额配置）
• 执行结果实时反馈至控制平面

多集群支持

• 单个Agent实例对应单个目标集群
• 支持多集群并行部署与独立管理
• 集群间数据隔离与权限边界控制

部署特性

• 轻量级设计，资源占用低（默认配置下CPU<100m，内存<256Mi）
• 自动重连机制，网络中断后可恢复连接
• 支持TLS加密通信，保障数据传输安全

使用场景与适用范围

适用场景

• 企业级多Kubernetes集群统一管理
• 混合云/多云环境下的跨集群资源管控
• 分布式部署架构中的集群协同运维
• 需要集中监控与操作多集群的场景

适用范围

• Kubernetes集群版本：v1.16+
• 网络环境：目标集群需能访问Kuboard控制平面地址
• 权限要求：需在目标集群具备集群级别的资源访问权限（ClusterRole）

使用方法与配置说明

前置准备

1. 在Kuboard控制平面创建目标集群记录，获取集群唯一标识（CLUSTER_ID）
2. 生成Agent认证令牌（AGENT_TOKEN），用于与控制平面的身份验证
3. 确认目标集群已安装kubectl且配置正确的集群上下文

部署步骤

通过Kubernetes Deployment部署

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: kuboard-agent
  namespace: kuboard
spec:
  replicas: 1
  selector:
    matchLabels:
      app: kuboard-agent
  template:
    metadata:
      labels:
        app: kuboard-agent
    spec:
      containers:
      - name: kuboard-agent
        image: eipwork/kuboard-agent:v3.0
        env:
        - name: KUBOARD_SERVER_URL
          value: "[***]"  # 替换为实际Kuboard控制平面地址
        - name: CLUSTER_ID
          value: "cluster-xxxxxx"  # 替换为控制平面生成的集群ID
        - name: AGENT_TOKEN
          value: "your-agent-token"  # 替换为控制平面生成的认证令牌
        - name: LOG_LEVEL
          value: "info"  # 日志级别：debug|info|warn|error
        resources:
          requests:
            cpu: "50m"
            memory: "128Mi"
          limits:
            cpu: "200m"
            memory: "512Mi"

部署命令

bash
# 创建命名空间
kubectl create namespace kuboard

# 应用部署配置
kubectl apply -f kuboard-agent-deployment.yaml

# 查看部署状态
kubectl get pods -n kuboard -l app=kuboard-agent

配置参数说明

部署验证

1. 检查Agent Pod运行状态：

bash
kubectl logs -n kuboard -l app=kuboard-agent

2. 成功连接控制平面的日志特征：

INFO[0000] Agent connected to Kuboard server: [***] 
INFO[0002] Cluster resource sync started, interval=30s 

3. 在Kuboard控制平面集群列表中查看目标集群状态变为"在线"

注意事项

• 确保目标集群与Kuboard控制平面之间网络通畅（默认需开放控制平面的HTTP/HTTPS端口）
• AGENT_TOKEN需妥善保管，避免泄露导致未授权访问
• 升级Kuboard控制平面时，建议同步更新集群端Agent至匹配版本
• 大规模集群（节点数>100）建议将SYNC_INTERVAL调整为60-120秒，减少资源消耗