---

一、Kuboard 简介

Kuboard 是一款专为 Kubernetes 设计的免费管理界面，提供了丰富的功能，结合已有或新建的代码仓库、镜像仓库、CI/CD工具等，可以便捷的搭建一个生产可用的 Kubernetes 容器云平台，轻松管理和运行云原生应用。兼容 Kubernetes 版本 1.13 及以上。Kuboard 每周发布一个 beta 版本，最长每月发布一个正式版本，经过两年的不断迭代和优化，已经具备多集群管理、权限管理、监控套件、日志套件等丰富的功能，并且有 1000+ 的企业将 Kuboard 应用于其生产环境。Kuboard 自 2019年8月发布第一个版本以来，得到了众多用户的认可，目前已经获得了 10000+ GitHub Star。

二、安装方式

Kuboard v3.x 是目前最新版本，支持 Kubernetes 多集群管理。
基于如下原因，建议以 docker run 的方式运行 Kuboard：

1. 结构更清晰（Kuboard 作为多个集群的管理界面应该独立于任何集群之外，虽然安装在 Kubernetes 集群中的 Kuboard
   也可以管理多个集群）；
2. 登录 Kuboard 时使用不同的认证方式；
3. 问题排查更简单。

安装方式包括：

1. 内建用户库认证 （支持双因子认证 ）推荐
2. GitLab 单点登录
3. GitHub 单点登录
4. LDAP 认证
5. 高可用

三、安装

以下以内建用户库认证的方式进行安装。
安装指令如下：

docker run -d \
  --restart=unless-stopped \
  --name=kuboard \
  -p 80:80/tcp \
  -p 10081:10081/udp \
  -p 10081:10081/tcp \
  -e KUBOARD_ENDPOINT="http://192.168.1.28:80" \
  -e KUBOARD_AGENT_SERVER_UDP_PORT="10081" \
  -e KUBOARD_AGENT_SERVER_TCP_PORT="10081" \
  -v /root/kuboard-data:/data \
  eipwork/kuboard:v3.5.0.2
1
2
3
4
5
6
7
8
9
10
11

四、升级

1.停止已有 kuboard 容器

docker stop $(docker ps -a | grep "eipwork/kuboard" | awk '{print $1 }')
docker rm $(docker ps -a | grep "eipwork/kuboard" | awk '{print $1 }')
1
2

2.使用新版本的镜像启动 kuboard

docker run -d \
  --restart=unless-stopped \
  --name=kuboard \
  -p 80:80/tcp \
  -p 10081:10081/udp \
  -p 10081:10081/tcp \
  -e KUBOARD_ENDPOINT="http://192.168.1.28:80" \
  -e KUBOARD_AGENT_SERVER_UDP_PORT="10081" \
  -e KUBOARD_AGENT_SERVER_TCP_PORT="10081" \
  -v /root/kuboard-data:/data \
  eipwork/kuboard:v3.5.0.2
1
2
3
4
5
6
7
8
9
10
11

五、访问

浏览器输入：http://your-host-ip:80，用户 / 密码 为 admin / Kuboard123：（请使用 Chrome / FireFox / Safari 等浏览器，不兼容 IE 以及以 IE 为内核的浏览器）

登录后界面如下：

添加集群：