Files
kuboard-press/install/v3/install-built-in.md
2020-12-28 21:12:50 +08:00

4.2 KiB
Raw Blame History

lessAds, description, meta
lessAds description meta
false 一行命令开启Kubernetes多集群管理之路_Kuboard_V3安装
name content
keywords Kubernetes Dashboard安装,Kuboard安装,K8S Dashboard安装

安装 Kuboard v3 - 内建用户库

beta 版本说明

Kuboard v3.0 支持 Kubernetes 多集群管理。当前为 beta 版本,已经验证了大部分 v2 版本中的功能,有如下功能尚未验证:

  • Kuboard PortForward

Kuboard v3.0 正式发布时间预计在 2021 年元旦节前后。

如果您从 Kuboard v1.0.x 或者 Kuboard v2.0.x 升级到 Kuboard请注意

  • 您可以同时使用 Kuboard v3.0.x 和 Kuboard v2.0.x
  • Kuboard v3.0.x 在正式发布时,考虑将 Kuboard 相关的所有组件从 kube-system 名称空间迁移到 kuboard 名称空间;

beta 版本为早期内测版本,预计 Kuboard v3.0.0 的正式发布时间在 2021 年元旦前后

部署计划

在正式安装 kuboard v3 之前,需做好一个简单的部署计划的设计,在本例中,各组件之间的连接方式,如下图所示:

  • 假设用户通过 http://kuboard.mycompany.com 访问 Kuboard v3

  • 安装在 Kubernetes 中的 Kuboard Agent 通过 kuboard.mycompany.com 访问 Kuboard 的 Web 服务端口 80 / 443 和 Kuboard Agent Server 端口 10081。

    ::: tip 域名解析

    • 必须能够通过 DNS 正确解析到该域名,如果直接在宿主机配置 /etc/hosts 文件,将不能正常运行;
    • 如果不方便配置 DNS也可以直接使用 IP 地址,例如 http://192.168.32.21。 :::

安装 Kuboard 之前,假设:

  • 您已经准备好了一个 Linux 服务器用于安装 Kuboard-V3并且该机器上的 docker 版本不低于 19.03
  • 用于安装 Kuboard v3.0 的机器已经安装了 docker并且版本不低于 docker 19.03
  • 您已经有自己的 Kubernetes 集群,并且版本不低于 Kubernetes v1.13

安装

安装 Kuboard v3.0 beta 版本的指令如下:

sudo docker run -d \
  --restart=unless-stopped \
  --name=kuboard \
  -p 80:80/tcp \
  -p 10081:10081/udp \
  -p 10081:10081/tcp \
  -e KUBOARD_ENDPOINT="http://kuboard.mycompany.com" \
  -e KUBOARD_AGENT_SERVER_UDP_PORT="10081" \
  -e KUBOARD_AGENT_SERVER_TCP_PORT="10081" \
  -v /root/kuboard-data:/data \
  eipwork/kuboard:v3-beta
  # 也可以使用镜像 swr.cn-east-2.myhuaweicloud.com/kuboard/kuboard:v3-beta ,可以更快地完成镜像下载。

::: danger kuboard.mycompany.com 是一个假想域名,请替换成您自己的域名(运行 Kuboard 的宿主机以及所有 Kubernetes 节点都可以解析该域名),或者使用 IP 地址; :::

::: tip 参数解释

  • 建议将此命令保存为一个 shell 脚本,例如 start-kuboard.sh,后续升级 Kuboard 或恢复 Kuboard 时,需要通过此命令了解到最初安装 Kuboard 时所使用的参数;
  • 第 4 行,将 Kuboard Web 端口 80 映射到宿主机的 80 端口(您可以根据自己的情况选择宿主机的其他端口);
  • 第 5、6 行,将 Kuboard Agent Server 的端口 10081/udp10081/tcp 映射到宿主机的 10081 端口(您可以根据自己的情况选择宿主机的其他端口);
  • 第 7 行,指定 KUBOARD_ENDPOINT 为 http://kuboard.mycompany.com,如果后续修改此参数,需要将已导入的 Kubernetes 集群从 Kuboard 中删除,再重新导入;
  • 第 8、9 行,指定 KUBOARD_AGENT_SERVER 的端口为 10081,此参数与第 5、6 行中的宿主机端口应保持一致,修改此参数不会改变容器内监听的端口 10081
  • 第 10 行,将持久化数据 /data 目录映射到宿主机的 /root/kuboard-data 路径,请根据您自己的情况调整宿主机路径; :::

访问 Kuboard v3.0

在浏览器输入 http://your-host-ip 即可访问 Kuboard v3.0 的界面,登录方式:

  • 用户名: admin
  • 密 码: Kuboard123

问题反馈

关于 Kuboard v3.0.0-beta 版本的问题反馈,请加 QQ 群656520037