文章目录
- 安装 Kuboard v3
- 部署计划
- 安装
- 登录测试
安装 Kuboard v3
部署计划
-
在正式安装 kuboard v3 之前,需做好一个简单的部署计划的设计,在本例中,各组件之间的连接方式,如下图所示:
- 假设用户通过 http://外网IP:80 访问 Kuboard v3;
- 安装在 Kubernetes 中的 Kuboard Agent 通过 内网IP 访问 Kuboard 的 Web 服务端口 80 和 Kuboard Agent Server 端口 10081。
-
安装 Kuboard 之前,假设:
- 您已经准备好了一个 Linux 服务器用于安装 Kuboard-V3,并且该机器上的 docker 版本不低于 19.03
- 用于安装 Kuboard v3.x 的机器已经安装了 docker,并且版本不低于 docker 19.03
- 您已经有自己的 Kubernetes 集群,并且版本不低于 Kubernetes v1.13
安装
安装 Kuboard v3.x 版本的指令如下:
docker run -d \--restart=unless-stopped \--name=kuboard \-p 88:80/tcp \-p 10081:10081/tcp \-e KUBOARD_ENDPOINT="http://192.168.33.102:88" \-e KUBOARD_AGENT_SERVER_TCP_PORT="10081" \-v /root/kuboard-data:/data \eipwork/kuboard:v3# 也可以使用镜像 swr.cn-east-2.myhuaweicloud.com/kuboard/kuboard:v3
WARNING
KUBOARD_ENDPOINT
参数的作用是,让部署到Kubernetes
中的kuboard-agent
知道如何访问 > >Kuboard Server
;
KUBOARD_ENDPOINT
中也可以使用外网IP
;
Kuboard
不需要和 K8S 在同一个网段,Kuboard Agent
甚至可以通过代理访问Kuboard Server
;
建议在KUBOARD_ENDPOINT
中使用域名;
如果使用域名,必须能够通过DNS
正确解析到该域名,如果直接在宿主机配置/etc/hosts
文件,将> 不能正常运行;
参数解释
建议将此命令保存为一个 shell 脚本,例如
start-kuboard.sh
,后续升级 Kuboard 或恢复 Kuboard 时,需要通过此命令了解到最> 初安装 Kuboard 时所使用的参数;
第 4 行,将 Kuboard Web 端口80
映射到宿主机的88
端口(您可以根据自己的情况选择宿主机的其他端口);
第 5 行,将 Kuboard Agent Server 的端口10081/tcp
映射到宿主机的10081
端口(您可以根据自己的情况选择宿主机的其他端> 口);
第 6 行,指定KUBOARD_ENDPOINT
为http://内网IP
,如果后续修改此参数,需要将已导入的 Kubernetes 集群从 Kuboard 中删除,再重新导入;
第 7 行,指定 KUBOARD_AGENT_SERVER 的端口为 10081,此参数与第 5 行中的宿主机端口应保持一致,修改此参数不会> 改变容器内监听的端口 10081,例如,如果第 5 行为-p 30081:10081/tcp
则第 7 行应该修改为-e KUBOARD_AGENT_SERVER_TCP_PORT="30081"
;
第 8 行,将持久化数据/data
目录映射到宿主机的/root/kuboard-data
路径,请根据您自己的情况调整宿主机路径;
其他:
在启动命令行中增加环境变量
KUBOARD_ADMIN_DERAULT_PASSWORD
,可以设置admin
用户的初始默认密码
注意:我用
swr.cn-east-2.myhuaweicloud.com/kuboard/kuboard:v3
这个镜像会报错runtime/cgo: pthread_create failed: Operation not permitted
,如果启动不起来 推荐默认的eipwork/kuboard:v3
登录测试
http://192.168.33.102:88
- 用户名: admin
- 密 码: Kuboard123