部署Kuboard - Kubernetes 多集群管理界面
安装 Kuboard v3 - kubernetes 官方文档
方法一:使用 hostPath 提供持久化
kubectl apply -f https://addons.kuboard.cn/kuboard/kuboard-v3.yaml
# 您也可以使用下面的指令,唯一的区别是,该指令使用华为云的镜像仓库替代 docker hub 分发 Kuboard 所需要的镜像
# kubectl apply -f https://addons.kuboard.cn/kuboard/kuboard-v3-swr.yaml
等待 Kuboard v3 就绪后,执行指令 watch kubectl get pods -n kuboard
,等待 kuboard 名称空间中所有的 Pod 就绪,如下所示,如果结果中没有出现 kuboard-etcd-xxxxx
的容器,请查看 常见错误 中关于 缺少 Master Role
的描述。
[root@node1 ~]# kubectl get pods -n kuboard
NAME READY STATUS RESTARTS AGE
kuboard-agent-2-65bc84c86c-r7tc4 1/1 Running 2 28s
kuboard-agent-78d594567-cgfp4 1/1 Running 2 28s
kuboard-etcd-fh9rp 1/1 Running 0 67s
kuboard-etcd-nrtkr 1/1 Running 0 67s
kuboard-etcd-ader3 1/1 Running 0 67s
kuboard-v3-645bdffbf6-sbdxb 1/1 Running 0 67s
访问 Kuboard
- 在浏览器中打开链接
http://your-node-ip-address:30080
- 输入初始用户名和密码,并登录
- 用户名:
admin
- 密码:
Kuboard123
- 用户名:
安装常见错误
-
kuboard-v3-xxxxx 的容器出现 CrashLoopBackOff 的状态,可能的原因有:
- 缺少 kuboard-etcd-xxxx 容器,请查看后面关于 缺少 Master Role 的描述;
-
kuboard-etcd-xxxx 容器未就绪,请查看 kuboard-etcd-xxxx 容器的日志,解决其不能启动的问题;
- kuboard-agent-xxxxx 出现 CrashLoopBackOff 的状态,可能的原因有:
- 其依赖的 kuboard-v3 尚未就绪,请耐心等候一会儿即可(根据您的服务器下载镜像速度的不同,大约 3-5 分钟);
- kuboard-v3 已经处于 READY (1/1)状态,但是集群的网络插件配置错误或者其他的网络因素,导致 kuboard-agent 的容器不能访问到 kuboard-v3 的容器;
-
可能缺少 Master Role 的情况有:
- 当您在 阿里云、腾讯云(以及其他云)托管 的 K8S 集群中以此方式安装 Kuboard 时,您执行
kubectl get nodes
将 看不到 master 节点; - 当您的集群是通过二进制方式安装时,您的集群中可能缺少 Master Role,或者当您删除了 Master 节点的
node-role.kubernetes.io/master=
标签时,此时执行kubectl get nodes
,结果如下所示:
- 当您在 阿里云、腾讯云(以及其他云)托管 的 K8S 集群中以此方式安装 Kuboard 时,您执行
[root@k8s-19-master-01 ~]# kubectl get nodes
NAME STATUS ROLES AGE VERSION
k8s-19-master-01 Ready <none> 19d v1.19.11
k8s-19-node-01 Ready <none> 19d v1.19.11
k8s-19-node-02 Ready <none> 19d v1.19.11
k8s-19-node-03 Ready <none> 19d v1.19.11
- 在集群中缺少 Master Role 节点时,您也可以为一个或者三个 worker 节点添加
k8s.kuboard.cn/role=etcd
的标签,来增加 kuboard-etcd 的实例数量;- 执行如下指令,可以为
your-node-name
节点添加所需要的标签
- 执行如下指令,可以为
kubectl label nodes your-node-name k8s.kuboard.cn/role=etcd
etcd
- Kuboard V3 依赖于 etcd 提供数据的持久化服务,在当前的安装方式下,kuboard-etcd 的存储卷被映射到宿主机节点的 hostPath (/usr/share/kuboard/etcd 目录);
- 为了确保每次重启,etcd 能够加载到原来的数据,以 DaemonSet 的形式部署 kuboard-etcd,并且其容器组将始终被调度到 master 节点,因此,您有多少个 master 节点,就会调度多少个 kuboard-etcd 的实例;
- 某些情况下,您的 master 节点只有一个或者两个,却仍然想要保证 kubuoard-etcd 的高可用,此时,您可以通过为一到两个 worker 节点添加
k8s.kuboard.cn/role=etcd
的标签,来增加 kuboard-etcd 的实例数量;- 如果您已经安装了 Kuboard V3,通过此方式调整 etcd 数量时,需要按照如下步骤执行,否则 etcd 将不能正常启动:
- 执行
kubectl delete daemonset kuboard-etcd -n kuboard
- 为节点添加标签
- 执行
kubectl apply -f https://addons.kuboard.cn/kuboard/kuboard-v3.yaml
- 执行
- 如果您已经安装了 Kuboard V3,通过此方式调整 etcd 数量时,需要按照如下步骤执行,否则 etcd 将不能正常启动:
- 建议 etcd 部署的数量为 奇数
卸载
-
执行 Kuboard v3 的卸载
kubectl delete -f https://addons.kuboard.cn/kuboard/kuboard-v3.yaml
-
清理遗留数据
在 master 节点以及带有
k8s.kuboard.cn/role=etcd
标签的节点上执行rm -rf /usr/share/kuboard
方法二:使用 StorageClass 提供持久化
获取部署 Kuboard 所需的 YAML 文件:
curl -o kuboard-v3.yaml https://addons.kuboard.cn/kuboard/kuboard-v3-storage-class.yaml
编辑 kuboard-v3.yaml
文件中的配置,该部署文件中,有两处配置必须修改:KUBOARD_ENDPOINT
storageClassName
---
apiVersion: v1
kind: ConfigMap
metadata:
name: kuboard-v3-config
namespace: kuboard
data:
# 关于如下参数的解释,请参考文档 https://kuboard.cn/install/v3/install-built-in.html
# [common]
KUBOARD_ENDPOINT: 'http://your-node-ip-address:30080'
KUBOARD_AGENT_SERVER_UDP_PORT: '30081'
KUBOARD_AGENT_SERVER_TCP_PORT: '30081'
volumeClaimTemplates:
- metadata:
name: data
spec:
# 请填写一个有效的 StorageClass name
storageClassName: please-provide-a-valid-StorageClass-name-here
accessModes: [ "ReadWriteMany" ]
resources:
requests:
storage: 5Gi
部署到 Kubernetes 集群
kubectl create -f kuboard-v3.yaml
访问 Kuboard
- 在浏览器中打开链接
http://your-node-ip-address:30080
- 输入初始用户名和密码,并登录
- 用户名:
admin
- 密码:
Kuboard123
- 用户名:
kubectl delete -f https://addons.kuboard.cn/kuboard/kuboard-v3-storage-class.yaml
备注
此 YAML 文件向 Kubernetes 中部署了一个三副本的 StatefulSet kuboard-etcd
和一个单副本的 Deployment kuboard-v3
;其中 Deployment kuboard-v3
暂时不支持多副本,请保持其 replicas 字段为 1,将在后续的版本升级中解决 kuboard-v3
多副本部署的问题。