单机体验版本

通过快速安装脚本安装的 Rainbond 是属于单机体验版本，如果在安装时出现问题，请根据当前的文档进行排查问题。

启动流程

Rainbond 单机体验版本 是将所有的服务都运行在一个容器中，方便用户快速使用，采用了 dind (Docker in Docker) 的技术，所有的排查操作都在 rainbond-allione 这个容器环境中进行。

在整个安装过程中，会按照以下顺序依次启动服务：

1. 启动 Containerd 服务，由 Supervisord 控制启动。
   • 日志路径：/app/logs/containerd.log
2. Load 容器镜像包。
3. 启动 K3s 服务，由 Supervisord 控制启动。
   • 日志路径：/app/logs/k3s.log
4. 启动 Rainbodn Region。
   • 运行在 K3s 之上，以 POD 运行。
5. 启动 Rainbond Console，由 Supervisord 控制启动。

排查思路

整个排查的过程，也将围绕这些任务的执行情况开展。

开始排查之前，启动新的终端，执行以下命令，进入 rainbond-allinone 容器环境中：

docker exec -it rainbond-allinone bash

启动 Containerd 阶段

rainbond-allinone 容器中会启动一个以后台进程方式运行的 Containerd 服务，后续会通过它启动和管理一系列的容器。

如果 Containerd 启动失败，你将会在 rainbond-allinone 的启动日志中看到：

ERROR: Containerd failed to start. Please use the command to view the containerd log 'docker exec rainbond-allinone /bin/cat /app/logs/containerd.log'

根据日志中的命令，执行命令查看 Containerd 日志:

tail -f /app/logs/containerd.log

根据 Containerd 日志排查错误，结合 Containerd 官方文档进行查询。

Load 镜像阶段

在 Load 镜像阶段，使用 nerdctl 工具进行 load。

如果您遇到 Load 失败，该阶段会一直循环 Load。

Load 镜像常见问题

如果在 Win、Mac 上部署并使用 -v local:/app/data 将数据挂载到了本地，将会遇到 Load 失败的现象，这是因为本地的存储与 Docker 存储驱动不一致导致的。

tip

需要将存储修改为 Docker Volume 卷的方式挂载可解决问题。

启动 K3s 阶段

rainbond-allinone 容器中会启动一个以后台进程方式运行的 K3s 服务，作为容器内部的编排工具。

如果 K3s 启动失败，你将会在 rainbond-allinone 的启动日志中看到：

ERROR: K3s failed to start. Please use the command to view the k3s log 'docker exec rainbond-allinone /bin/cat /app/logs/k3s.log

根据日志中的命令，执行命令查看 K3s 日志：

tail -f /app/logs/k3s.log

根据 K3s 日志排查错误。

k3s常见问题列表

Failed to create cgroup" err="cannot enter cgroupv2 \"/sys/fs/cgroup/kubepods\" with domain controllers -- it is in an invalid state

info

在早些版本的 rainbond-allinone 中，尚未支持 cgroupv2。而 cgroupv2 在高于 4.2.0 版本的 Docker Desktop 中被应用，这导致了冲突。所以请降级 Docker Desktop 到 4.2.0 版本及以下。或使用最新版本的单机体验版本的 Rainbond。

level=info msg="Set sysctl 'net/netfilter/nf_conntrack_max' to 196608
level=error msg="Failed to set sysctl: open /proc/sys/net/netfilter/nf_conntrack_max: permission denied

info

遭遇以上问题时，可以在主机中修改对应的参数为日志中的相同值，在 linux 操作系统中，执行 sysctl -w net/netfilter/nf_conntrack_max=196608 ; 如果上述操作没有能够解决问题，或者在非 linux 操作系统中遭遇这个问题，可以在 docker run ... 启动命令中添加环境变量 -e K3S_ARGS="--kube-proxy-arg=conntrack-max-per-core=0"。

/usr/lib/libbz2.so.1.0.8: no space left on device

info

主机中的磁盘空间不足，增加磁盘空间或删除不必要的文件释放空间；对于 Docker Desktop 用户而言，可以参考 Disk utilization 学习变更磁盘空间限额。

启动 Rainbond Region 阶段

rainbond-allinone 容器中会在 rbd-system 命名空间下启动 Rainbond Region POD。在终端命令行中执行以下命令获取这些 POD 的信息。

kubectl get pod -n rbd-system

通过观察 pod 的运行状态，预期的运行状态是 n/n Running

NAME                                         READY   STATUS    RESTARTS   AGE
rbd-etcd-0                                   1/1     Running   0          2d22h
rainbond-operator-5f785ff5f6-2dvq6           1/1     Running   0          2d22h
rbd-gateway-4ss6z                            1/1     Running   0          2d22h
rbd-hub-64777d89d8-vvjn5                     1/1     Running   0          2d22h
rbd-node-bsmnj                               1/1     Running   0          2d22h
rbd-webcli-8c6849dc6-8lx98                   1/1     Running   0          2d22h
rbd-mq-5fcfb64d86-w8bjl                      1/1     Running   0          2d22h
rbd-monitor-0                                1/1     Running   0          2d22h
kubernetes-dashboard-fbd4fb949-5lf88         1/1     Running   0          2d22h
dashboard-metrics-scraper-7db45b8bb4-mqbpm   1/1     Running   0          2d22h
rbd-resource-proxy-8654b98bc9-4rvnq          1/1     Running   0          2d22h
rbd-db-0                                     2/2     Running   0          2d22h
rbd-chaos-xn6zr                              1/1     Running   0          2d22h
rbd-worker-8664fb5d9-zcfw4                   1/1     Running   0          2d22h
rbd-eventlog-0                               1/1     Running   0          2d22h
rbd-api-6f6c565856-bq9bp                     1/1     Running   0          2d22h

当以上的某些 pod 并非处于 Running 状态时，就需要根据其当前状态进行排查。异常的状态可能包含：

• Pending
• CrashLoopBackOff
• Evicted

info

Pending 状态意味着当前 pod 没有能够正常进入启动流程，pod 可能被启动之前所需要执行的任务阻塞，所以处于待定（Pending）状态。要了解 pod (以 rbd-etcd-0 为例)的启动为何遭遇阻塞，可以执行命令 kubectl describe pod rbd-etcd-0 -n rbd-system ，观察最后的 events 部分输出内容来确定 pod 当前事件。并根据提示深入排查。

info

CrashLoopBackOff 状态意味着当前 pod 已经可以正常启动，但是其内部的容器自行退出，这通常是因为内部的服务出了问题。要了解 pod (以 rbd-etcd-0 为例)的启动为何失败，可以执行命令 kubectl logs -f rbd-etcd-0 -n rbd-system ，观察日志的输出，通过业务日志来确定问题原因。

info

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

启动 Rainbond Console 阶段

rainbond-allinone 容器中会启动 Rainbond Console 服务，它是由 Supervisord 控制启动。

如果需要 Console 无法访问的情况，请排查以下日志分析问题：

/app/logs/console.log
/app/logs/console_error.log

修改挂载存储目录路径

Rainbond dind 单机体验版默认会将数据存储在两个目录内，容器内数据目录为 /app/data /opt/rainbond，而宿主机的目录分两种情况：

1. Linux 安装的单机体验版默认的本地数据目录是 ~/rainbonddata /opt/rainbond。
2. Mac、Windows 安装的单机体验版存在 docker volume 中，可以通过 docker volume ls 命令查看，rainbond-data rainbond-opt。

基于 Mac、Windows 安装的单机体验版，无法更改为本地目录，如果因为存储空间满了导致平台无法功能，请通过 Docker Desktop 扩容存储空间。

基于 Linux 安装的单机体验版，可以通过修改 install.sh 安装脚本中的 volume 字段，修改默认的本地目录，如下：

tip

如果已经存在数据，需要将数据迁移到新的目录中。

$ vim install.sh
VOLUME_OPTS="-v ~/.ssh:/root/.ssh -v <local_path>:/app/data -v <local_path>:/opt/rainbond"

删除 rainbond-allinone 容器，然后重新执行 install.sh 脚本即可。

docker rm -f rainbond-allinone
bash ./install.sh