Kuboard 部署与实践
在 Kubernetes 集群管理中,虽然 kubectl 命令行灵活强大,但面对复杂的资源编排时,可视化工具往往能大幅降低操作门槛。Kuboard 作为一款轻量且功能全面的 K8s 管理界面,支持集群导入、资源创建及状态监控,部署流程也相对简单。
下面我们将基于已搭建的 K8s 环境,演示 Kuboard 的安装、集群接入,并通过 YAML 和界面两种方式实践 Pod 与服务的管理。
一、部署准备
1.1 前提条件
确保你拥有一个运行正常的 K8s 集群,且当前操作节点(通常是 Master 节点)具备执行 kubectl 命令的权限,即已配置好集群管理员证书。
1.2 官方文档参考
Kuboard 提供了详细的部署文档和 Demo 环境,建议提前浏览以熟悉功能: 官网地址:https://demo.kuboard.cn/
二、Kuboard 部署步骤
2.1 执行部署命令
我们直接使用 kubectl apply 拉取官方清单,一键创建所需的命名空间、配置文件及服务账户等资源:
kubectl apply -f https://addons.kuboard.cn/kuboard/kuboard-v3.yaml
执行成功后会看到一系列资源创建成功的日志,无需额外修改,直接继续即可。
2.2 检查 Pod 状态
部署完成后,需要确认 kuboard 命名空间下的 Pod 是否全部处于 Running 状态,这标志着组件已正常启动:
kubectl get pod -n kuboard
正常情况下 READY 列应显示为 1/1,STATUS 列为 Running。如果 Pod 卡在 Pending 或 Error 状态,可以使用 kubectl describe pod <Pod 名称> -n kuboard 查看具体原因,常见的问题包括镜像拉取失败或节点资源不足。
2.3 检查服务暴露情况
Kuboard 通过 NodePort 类型的 Service 暴露外部访问端口,重点确认 30080 端口的映射关系:
kubectl get svc -n kuboard
输出中 TYPE 应为 NodePort,PORT(S) 中的 80:30080/TCP 表示集群内 80 端口映射到了节点的 30080 端口,这正是 Web 界面访问的地址。
三、界面访问与集群导入
3.1 访问 Web 界面
打开浏览器,输入访问地址:http://<Master 节点 IP>:30080/(请将 IP 替换为你实际的 Master 节点地址)。首次登录使用默认管理员账号密码:
- 账号:admin
- 密码:Kuboard123

3.2 导入 Kubernetes 集群
登录后需要将现有的 K8s 集群接入 Kuboard 统一管理:
- 点击左侧菜单栏【Kubernetes 集群】,选择【Kubernetes 集群列表】并点击【添加集群】。
- 导入方式保持默认的 Token,集群名称可设为 k8s-cluster。
- 根据页面提示复制脚本到 Master 节点执行,用于自动创建 ServiceAccount 及访问凭证。
- 执行完脚本后,复制红色输出字段中的 token 值。
- 回到导入界面填写信息:
- 名称:自定义集群名称



