andre/kuboard-press

Fork 0

Files

Shao Huan Qing 48357411a2 优化安装的错误提示

2021-09-05 16:24:27 +08:00

14 KiB

Raw Blame History

lessAds, description, meta

lessAds

description

在 K8S 中安装 Kuboard v3

在 K8S 中安装 Kuboard，主要考虑的问题是，如何提供 etcd 的持久化数据卷。建议的两个选项有：

使用 hostPath 提供持久化存储，将 kuboard 所依赖的 Etcd 部署到 Master 节点，并将 etcd 的数据目录映射到 Master 节点的本地目录；推荐
使用 StorageClass 动态创建 PV 为 etcd 提供数据卷；不推荐

方法一：使用 hostPath 提供持久化

安装

执行 Kuboard v3 在 K8S 中的安装
```
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
```
::: tip 定制参数如果您想要定制 Kuboard 的启动参数，请将该 YAML 文件下载到本地，并修改其中的 ConfigMap :::
- 在您的镜像仓库服务中创建一个名为 kuboard 的 repository（harbor 中称之为项目、华为镜像仓库中称之为组织）
- 输入您镜像仓库地址及 repository 名称（替换输入框中 registry.mycompayn.com 为你的镜像仓库服务地址即可）：
- 将所需镜像导入到您的私有镜像仓库
```
    {{dockerPull}}
  
```
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  请先输入私有镜像仓库
- 在您的镜像仓库设置导入的镜像为公开可访问（无需镜像仓库的用户名密码）
- 获取 YAML 文件，并将该文件保存到集群 master 节点（或者 kubectl 客户端所在机器，假设文件名为 kuboard-v3.yaml）
  
  <b-button variant="primary" @click="save">保存 YAML 到文件复制 YAML 到粘贴板
- 执行安装指令
```
kubectl apply -f kuboard-v3.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
```
常见错误 ::: tip CrashLoopBackOff * 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 的容器； :::
::: danger 缺少 Master Role
- 可能缺少 Master Role 的情况有：
  - 当您在 阿里云、腾讯云（以及其他云）托管 的 K8S 集群中以此方式安装 Kuboard 时，您执行 kubectl get nodes 将 看不到 master 节点；
  - 当您的集群是通过二进制方式安装时，您的集群中可能缺少 Master Role，或者当您删除了 Master 节点的 node-role.kubernetes.io/master= 标签时，此时执行 kubectl get nodes，结果如下所示：
```
[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
```
:::

::: tip 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 将不能正常启动：
    1. 执行 kubectl delete daemonset kuboard-etcd -n kuboard
    2. 为节点添加标签
    3. 执行 kubectl apply -f https://addons.kuboard.cn/kuboard/kuboard-v3.yaml
- 建议 etcd 部署的数量为奇数 :::

访问 Kuboard

在浏览器中打开链接 http://your-node-ip-address:30080
输入初始用户名和密码，并登录
- 用户名： admin
- 密码： Kuboard123

::: tip 浏览器兼容性

请使用 Chrome / FireFox / Safari / Edge 等浏览器

不兼容 IE 以及以 IE 为内核的浏览器

:::

::: tip 添加新的集群

Kuboard v3 是支持 Kubernetes 多集群管理的，在 Kuboard v3 的首页里，点击 添加集群 按钮，在向导的引导下可以完成集群的添加；
向 Kuboard v3 添加新的 Kubernetes 集群时，请确保：
- 您新添加集群可以访问到当前集群 Master 节点 内网IP 的 30080 TCP、30081 TCP、30081 UDP 端口；
- 如果您打算新添加到 Kuboard 中的集群与当前集群不在同一个局域网，请咨询 Kuboard 团队，帮助您解决问题。 :::

卸载

执行 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 提供持久化

::: danger 注意事项

刚接触 K8S 的同学，强烈建议您使用内建用户库的方式安装 Kuboard-v3，在 K8S 中安装 Kuboard v3 时，需要理解更复杂的端口映射方式、存储卷声明/存储类等概念。

:::

安装

获取部署 Kuboard 所需的 YAML 文件：

curl -o kuboard-v3.yaml https://addons.kuboard.cn/kuboard/kuboard-v3-storage-class.yaml

编辑 kuboard-v3.yaml 文件中的配置，该部署文件中，有两处配置必须修改：

KUBOARD_ENDPOINT

---
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'

storageClassName

  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

::: tip 浏览器兼容性

请使用 Chrome / FireFox / Safari / Edge 等浏览器

不兼容 IE 以及以 IE 为内核的浏览器

:::

卸载

执行 Kuboard v3 的卸载

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 多副本部署的问题。

14 KiB Raw Blame History Unescape Escape

在 K8S 中安装 Kuboard v3

方法一：使用 hostPath 提供持久化

安装

访问 Kuboard

卸载

方法二：使用 StorageClass 提供持久化

安装

访问 Kuboard

卸载

备注

14 KiB

Raw Blame History