集群管理
KubePolaris 支持同时管理多个 Kubernetes 集群。本文档介绍如何添加、管理和监控集群。
集群总览
在 集群管理 页面，你可以看到所有已导入集群的概览信息：
- 集群名称和状 态
- API Server 地址
- Kubernetes 版本
- 节点数量
- 资源使用情况
添加集群
步骤 1：进入添加页面
点击 集群管理 → 添加集群 按钮。
步骤 2：填写基本信息
| 字段 | 说明 | 示例 |
|---|---|---|
| 集群名称 | 用于标识集群的唯一名称 | production-cluster |
| 描述 | 集群用途说明（可选） | 生产环境主集群 |
| API Server | Kubernetes API 服务器地址 | https://192.168.1.100:6443 |
步骤 3：配置认证
KubePolaris 支持多种认证方式：
方式一：上传 Kubeconfig 文件
最简单的方式，直接上传现有的 kubeconfig 文件：
- 点击 上传 Kubeconfig
- 选择本地的 kubeconfig 文件
- 系统会自动解析配置
# 获取 kubeconfig 文件位置
echo $KUBECONFIG
# 通常在 ~/.kube/config
方式二：填写 Token
使用 ServiceAccount Token 认证：
- 选择 Token 认证
- 填写 Token 值
- 填写 CA 证书（可选，用于 HTTPS 验证）
# 创建 ServiceAccount 并获取 Token
kubectl create serviceaccount kubepolaris -n kube-system
# 创建 ClusterRoleBinding
kubectl create clusterrolebinding kubepolaris-admin \
--clusterrole=cluster-admin \
--serviceaccount=kube-system:kubepolaris
# 获取 Token (Kubernetes 1.24+)
kubectl create token kubepolaris -n kube-system --duration=8760h
方式三：客户端证书
使用客户端证书认证：
- 选择 证书认证
- 上传客户端证书 (
client.crt) - 上传客户端密钥 (
client.key) - 上传 CA 证书 (
ca.crt)
步骤 4：测试连接
点击 测试连接 按钮验证配置：
- ✅ 连接成功: 显示 Kubernetes 版本信息
- ❌ 连接失败: 显示错误信息，根据提示修正
步骤 5：保存
确认配置无误后，点击 保存 完 成集群添加。
集群详情
点击集群名称进入详情页，可以查看：
总览标签页
- 资源统计: CPU、内存、存储使用率
- 节点状态: Ready/NotReady 节点分布
- 工作负载: Deployment、Pod 等数量统计
- 近期事件: 最新的集群事件
节点标签页
查看集群中所有节点的详细信息：
- 节点名称和状态
- 角色（Master/Worker）
- 资源容量和使用率
- 标签和污点
命名空间标签页
列出所有命名空间及其资源统计。
事件标签页
实时查看集群事件，支持按类型筛选：
- Normal（正常）
- Warning（警告）
集群操作
编辑集群
- 点击集群行的 编辑 按钮
- 修改集群信息或认证配置
- 测试连接后保存
刷新状态
点击 刷新 按钮手动更新集群状态。
删除集群
- 点击集群行的 删除 按钮
- 在确认对话框中输入集群名称
- 点击确认删除
注意
删除集群只会从 KubePolaris 移除管理记录，不会影响实际的 Kubernetes 集群。
集群监控
内置监控
KubePolaris 内置基础监控指标：
- CPU 使用率趋势
- 内存使用率趋势
- Pod 数量变化
- 节点状态变化
Prometheus 集成
配置 Prometheus 后可获得更丰富的监控数据：
- 进入 系统设置 → 监控配置
- 填写 Prometheus 地址
- 保存配置
Grafana 面板
集成 Grafana 后可在集群详情页直接查看监控面板：
- 配置 Grafana 地址和 API Key
- 选择要展示的 Dashboard
- 在集群详情页查看内嵌面板
最佳实践
集群命名规范
建议使用有意 义的命名规范：
<环境>-<区域>-<用途>-<序号>
示例：
prod-us-east-app-01staging-cn-north-testdev-local-minikube
权限最小化
为 KubePolaris 创建专用的 ServiceAccount，按需授予权限：
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: kubepolaris-readonly
rules:
- apiGroups: [""]
resources: ["pods", "services", "nodes", "namespaces", "events"]
verbs: ["get", "list", "watch"]
- apiGroups: ["apps"]
resources: ["deployments", "statefulsets", "daemonsets", "replicasets"]
verbs: ["get", "list", "watch"]
定期检查连接
建议定期检查集群连接状态：
- 证书过期检查
- Token 有效性验证
- 网络连通性测试
常见问题
无法连接到集群
- 检查网络: 确保 KubePolaris 能访问 API Server
- 检查防火墙: 确保 6443 端口开放
- 检查证书: 确保证书未过期且正确
# 测试连接
curl -k https://<api-server>:6443/healthz
认证失败
- Token 过期: 重新生成 Token
- 权限不足: 检查 ClusterRoleBinding
- 证书错误: 确认使用正确的 CA 证书
集群状态异常
- 检查 Kubernetes 集群本身是否正常
- 检查 API Server 是否可访问
- 查看 KubePolaris 日志获取详细错误