Skip to main content
Version: V6.2

安装故障

Rainbond 在各种环境下的安装过程中，可能会遇到各种问题，本章节将会对 Rainbond 安装过程中的常见问题进行排查。

1. 快速安装故障排查​

Rainbond 快速安装版本是将所有的服务都运行在一个容器中，方便用户快速使用。在 Docker 容器中运行 K3s，所有的故障排查操作都在 rainbond 容器中进行。

排查思路​

容器启动过程都由 K3s 控制。在排查过程中，我们可以通过以下几个步骤来排查问题：

  1. 查看 rainbond 容器的启动日志，查看是否有错误信息。
  2. 查看 rainbond 容器中的 k3s 服务是否正常启动。
  3. 查看 rainbond 容器中的 rainbond 所有服务是否正常启动。

启动 K3s 阶段​

首先需要查看 rainbond 容器的启动日志，查看是否有错误信息。

docker logs -f rainbond

执行以下命令，进入 rainbond 容器，查看 rainbond 容器中的 k3s 服务是否正常启动。

docker exec -it rainbond bash

执行以下命令，查看 k3s 服务是否正常启动。

kubectl get node

启动 Rainbond 阶段​

执行以下命令，查看 rainbond 容器中的 rainbond 所有服务是否正常启动。

kubectl get pod -n rbd-system

可能遇到的问题​

Rainbond 快速安装版本默认会将数据存储 /opt/rainbond 目录中，如果磁盘空间不足，可能会导致 Rainbond 无法正常启动。

  1. 基于 Mac、Windows 安装无法更改为本地目录，请通过 Docker Desktop 扩容存储空间。
  2. 基于 Linux 安装可以通过修改 install.sh 安装脚本中的 volume 字段，修改默认的本地目录，如下：
$ vim install.sh

VOLUME_OPTS="-v /opt/rainbond:/opt/rainbond"
  1. 删除 rainbond 容器，然后重新执行 install.sh 脚本即可。
docker rm -f rainbond

bash ./install.sh

2. 基于 Kubernetes 安装故障排查​

Pod 处于Pending 、CrashLoopBackOff 、Evicted 、ImagePullBackOff等状态

  • Pending: 当 Pod 处于 Pending 状态时，代表其没有进入正常的启动流程，通过命令 kubectl describe pod xxx -n rbd-system 观察事件详情，来进一步进行排查。

  • CrashLoopBackOff: CrashLoopBackOff 状态意味着当前 Pod 已经可以正常启动，但是其内部的容器自行退出，这通常是因为内部的服务出了问题。通过命令 kubectl logs -f xxx -n rbd-system ，观察日志的输出，通过业务日志来确定问题原因。

  • Evicted: Evicted 状态意味着当前 Pod 遭到了调度系统的驱逐，触发驱逐的原因可能包括根分区磁盘占用率过高、容器运行时数据分区磁盘占用率过高等，根据经验，上述原因最为常见，需要进行磁盘空间清理解除驱逐状态。可以通过执行命令 kubectl describe node ，观察返回中的 Conditions 段落输出来确定当前节点的状态。

  • ImagePullBackOff: ImagePullBackOff 状态意味着 Pod 镜像下载失败退出，通常是因为镜像过大或者网络差引起的，通过命令 kubectl describe pod xxx -n rbd-system 观察事件详情，进一步进行排查。

3. 基于主机安装故障排查​

安装 K8S 阶段​

这个阶段 Rainbond 会提供一条命令用于安装 K8S 集群，实际上安装的过程都是在本地执行的。正常情况下，执行命令后，会自动安装 K8S 集群，直至在页面中查看节点为 Ready 状态即可进行下一步操作。

排查思路​

在目标服务器中执行安装命令后，会自动注册到 Rainbond 集群中，此时会处于 registering 状态。如果长时间处于 registering 状态，请检查以下问题：

  1. 首先检查 K8S 集群是否安装成功，通过以下命令查看节点状态。

    export KUBECONFIG=/etc/rancher/rke2/rke2.yaml
    /var/lib/rancher/rke2/bin/kubectl get nodes
    • 如果执行命令后，没有返回任何信息，请通过 journalctl -u rke2-server 或 journalctl -u rke2-agent 查看日志信息。
    • 如果执行命令后，节点状态为 NotReady 状态，请检查 kubectl get pod -n kube-system 命令的输出信息，查看 kube-proxy 、coredns 、metrics-server 等 Pod 是否处于 Running 状态。

  2. 检查 Rainbond 控制台的网络是否可以连接到目标服务器的 6443 端口，默认情况下会通过 https://<内网IP>:6443 连接（如填写了外网 IP 会通过 https://<外网IP>:6443 连接）。

安装 Rainbond 阶段​

常见问题​

  1. rbd-gateway 无法启动，通常是因为 rbd-gateway 有端口被占用，可以通过以下命令查看 rbd-gateway 的日志。
kubectl logs -f -n rbd-system -l name=rbd-gateway -c apisix