安装故障排查

本文主要是帮助你解决在安装过程中遇到的问题。

在安装的过程中，如果遇到了问题，首要任务是确认底层的 kubernetes 集群是否正常，包括检查 nodes，kubelet，kube-apiserver, kube-controller-manager, kube-schedler，coredns, 网络插件（比如：calico, flannel） 等。 因为 Kubernetes 的部署方式可以很灵活，一些组件有时候会以容器的方式运行，有时候直接以二进制文件的方式运行，所以排查方式也会有所不同。详情请查阅 Kubernetes 集群故障排查。

接下来的 kubectl 命令中，都会使用默认命名空间 rbd-system，如果使用了自定义域名，请自行替换。

无法选择网关节点

网关需要占用 80, 443, 6060, 7070, 8443, 10254, 18080, 18081 这些端口，所以安装网关的节点必须要确保这些端口没有被占用。否则无法被识别出来，并供搜索选择。 你可以将占用以上端口的应用部署到其他节点，或将相应端口改成其他端口。

10001 错误

10001 错误说明分配默认域名的服务暂时无法提供服务，这个时候，可以关闭 自动分配域名，并输入自定义的域名。

处理镜像卡住了

处理镜像卡住了，可能是处理的过程中出错了，也可能是网络原因，或者是 docker 的配置问题，导致拉取不到镜像。 这时候需要观察 operator 的日志来确认问题，命令如下：

  1. kubectl logs -f rainbond-operator-0 operator -n rbd-system

如果有报错，则是是处理的过程中出错了。那么可以执行以下命令，重新开始安装包的处理：

  1. kubectl get rainbondpackage rainbondpackage -o yaml -n rbd-system > rbd-pkg.yaml
  2. kubectl delete -f rbd-pkg.yaml
  3. kubectl create -f rbd-pkg.yaml

如果没有报错，且日志中含有 docker pull xxx, docker push xxx 的字眼，则是正在处理镜像。但是由于网络，或 docker 配置的原因， 导致拉取镜像比较慢，这时候需要做的是：

  • 检查网络
  • 检查 docker 配置，必要的时候可以加上阿里云的镜像加速

  • 确保可以正常获取镜像后，执行以下命令，重新开始安装包的处理：

    1. kubectl get rainbondpackage rainbondpackage -o yaml -n rbd-system > rbd-pkg.yaml
    2. kubectl delete -f rbd-pkg.yaml
    3. kubectl create -f rbd-pkg.yaml

NFS 服务无法挂载，导致 Rainbond 组件处于 FailedMount

Rainbond 组件在创建的过程中，状态处于 NotReady，原因是 FailedMount，消息如下：

  1. MountVolume.SetUp failed for volume "pvc-c600f712-e11e-48da-835e-29bca056f253" : mount failed: exit status 32 Mounting command: systemd-run Mounting arguments: --description=Kubernetes transient mount for /var/lib/kubelet/pods/595230c2-6354-4fd3-8122-0a20b4a1c223/volumes/kubernetes.io~nfs/pvc-c600f712-e11e-48da-835e-29bca056f253 --scope -- mount -t nfs 10.97.58.170:/export/pvc-c600f712-e11e-48da-835e-29bca056f253 /var/lib/kubelet/pods/595230c2-6354-4fd3-8122-0a20b4a1c223/volumes/kubernetes.io~nfs/pvc-c600f712-e11e-48da-835e-29bca056f253 Output: Running scope as unit: run-r599b201f5404416cbead03d30b6029be.scope mount: wrong fs type, bad option, bad superblock on 10.97.58.170:/export/pvc-c600f712-e11e-48da-835e-29bca056f253, missing codepage or helper program, or other error (for several filesystems (e.g. nfs, cifs) you might need a /sbin/mount.<type> helper program) In some cases useful info is found in syslog - try dmesg | tail or so.

特别是出现了 mount failed: exit status 32，说明你的机器缺少了 NFS 的客户端。请根据实际的系统去各机器上执行相应的命令：

  1. # Centos
  2. yum install -y nfs-utils
  4. # Ubuntu or Debian
  5. apt install -y nfs-common