跳到主要内容

在 K3s 上安装 Rainbond

本文将手把手教你如何在 K3s（一个轻量级的 Kubernetes 发行版）上安装 Rainbond。

准备工作​

什么是 K3s？​

K3s 是一个轻量级、完全兼容的 Kubernetes 发行版，专为边缘计算、物联网等资源受限环境设计。它打包为一个小于 100MB 的二进制文件，易于安装和管理。

环境要求​

  • 建议使用一个全新的、干净的操作系统。
  • 操作系统：Ubuntu 20.04 / CentOS 7+
  • 硬件：2核 CPU / 4GB 内存 / 40GB 磁盘以上
  • 确保端口 80, 443, 6060, 7070, 8443 未被占用。
  • 安装 Helm CLI。

安装 K3s​

创建 K3s 配置文件​

K3s 允许通过配置文件来自定义其行为。我们需要禁用一些内置组件，以避免与 Rainbond 冲突。

# 创建目录
mkdir -p /etc/rancher/k3s

# 创建 K3s 配置文件，禁用 traefik 和 local-storage
cat <<EOF > /etc/rancher/k3s/config.yaml
disable:
  - traefik
  - local-storage
system-default-registry: registry.cn-hangzhou.aliyuncs.com
EOF

说明：

  • traefik: K3s 内置的 Ingress Controller，需要禁用以避免与 Rainbond 网关冲突。
  • local-storage: K3s 内置的 Local Path Provisioner，需要禁用以使用 Rainbond 的默认存储。
  • system-default-registry: 使用国内镜像加速器，提升 K3s 自身组件的拉取速度。

创建私有镜像仓库配置文件，配置 Rainbond 默认内置的私有镜像仓库。

cat <<EOF > /etc/rancher/k3s/registries.yaml
configs:
  "goodrain.me":
    auth:
      username: admin
      password: admin1234
    tls:
      insecure_skip_verify: true
EOF

执行 K3s 安装脚本​

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn sh -s -

配置 Kubeconfig​

将 K3s 生成的 Kubeconfig 文件复制到默认路径，以便 kubectl 和 helm 命令可以直接使用。

cp /etc/rancher/k3s/k3s.yaml ~/.kube/config

安装 Rainbond​

  1. 添加 Helm 仓库。
helm repo add rainbond https://chart.rainbond.com
helm repo update
  1. 执行以下安装命令。如需指定自定义的values.yaml文件，请使用 -f 参数。
helm install rainbond rainbond/rainbond --create-namespace -n rbd-system 
......
NOTES:
Please use the following command to view the installation progress:

kubectl get pod -n rbd-system

Enter http://172.16.0.145:7070 in your browser to access Rainbond
  1. 执行安装命令后，使用上述 kubectl 命令查看安装进度。当所有 Pod 都处于 1/1 Running 状态且 rbd-app-ui 的 Pod 为 Running 状态时即安装成功。
安装成功结果示例
NAME                                      READY   STATUS    RESTARTS   AGE
local-path-provisioner-78d88b6df5-wkr84   1/1     Running   0          5m37s
minio-0                                   1/1     Running   0          5m37s
rainbond-operator-59ff8bb988-nlqrt        1/1     Running   0          5m56s
rbd-api-5466bd748f-brqmv                  1/1     Running   0          5m15s
rbd-app-ui-5577b8ff88-fpnnv               1/1     Running   0          4m39s
rbd-chaos-6828h                           1/1     Running   0          5m12s
rbd-db-0                                  1/1     Running   0          5m35s
rbd-gateway-69bfb68f4d-7xd9n              2/2     Running   0          5m34s
rbd-hub-8457697d4c-fqwgn                  1/1     Running   0          5m28s
rbd-monitor-0                             1/1     Running   0          5m27s
rbd-mq-5b6f94b695-gmdnn                   1/1     Running   0          5m25s
rbd-worker-7db9f9cccc-s9wml               1/1     Running   0          5m22s
  1. 通过终端打印的地址访问 Rainbond 控制台，如上例中的 http://172.16.0.145:7070。

常见问题与排查​

1. Pod 长时间 Pending 或 CrashLoopBackOff？​

  • 检查节点资源是否充足（CPU/内存）。
  • 检查 values.yaml 配置是否正确，特别是 containerdRuntimePath。
  • 查看 Pod 详细日志： 
    kubectl describe pod <pod-name> -n rbd-system
    kubectl logs <pod-name> -n rbd-system

2. 无法访问 Rainbond 网页？​

  • 检查服务器防火墙是否已放通 80, 443, 6060, 7070, 8443 端口。
  • 检查 gatewayIngressIPs 是否填写正确。
  • 检查 rbd-gateway Pod 是否 Running。

下一步​

Rainbond 安装完成后，你可以参考快速入门部署你的第一个应用。