跳到主要内容
返回视频教程列表

安装部署 / 已有 K8s 集群

基于 K8s 集群上 Helm 安装

在已有 Kubernetes 集群中添加 Rainbond Helm 仓库，执行 Helm 安装并验证控制台访问。

时长 00:51预计操作 8 分钟已经有 Kubernetes 集群、希望通过 Helm 安装 Rainbond 的用户
Helm 安装Kubernetes
基于 K8s 集群上 Helm 安装 视频封面
点击封面后将在新窗口打开 Rainbond 官方 B 站视频。B 站打开

本教程共 6 个操作步骤

准备 Kubernetes 环境

先确认已有 Kubernetes 集群、kubectl 和 Helm 都已经可用，并检查 Rainbond 需要使用的端口。

  • 准备 Containerd 运行时的 Kubernetes 1.24+ 集群。
  • 操作终端已安装 kubectl 和 Helm CLI，并能访问目标集群。
  • 确认 80、443、6060、7070、8443 端口可用。
检查集群和工具
kubectl get nodes -o wide
kubectl version --client
helm version
检查关键端口占用
sudo ss -lntp | grep -E ':(80|443|6060|7070|8443)\b' || echo "端口未被占用"
确认 Kubernetes 环境

执行安装前健康检查

使用 Rainbond 提供的检查脚本扫描集群基础环境，提前发现资源、端口或集群配置问题。

  • 检查脚本会对当前 Kubernetes 集群做基础校验。
  • 如果输出阻塞项，先按提示处理后再继续安装。
  • 健康检查通过后，再进入 Helm 仓库和安装命令步骤。
安装前检查命令
curl -sfL https://get.rainbond.com/k8s-health-check.sh | bash
安装前健康检查

添加 Rainbond Helm 仓库

将 Rainbond 官方 Helm 仓库添加到本地，并更新 Chart 索引，确保后续可以直接安装 Rainbond Chart。

  • helm repo add 只需要执行一次。
  • helm repo update 用于拉取最新的 Chart 索引。
  • 如果网络访问失败，先检查服务器出网和 DNS 解析。
添加 Helm 仓库
helm repo add rainbond https://chart.rainbond.com
helm repo update
添加 Helm 仓库

执行 Helm 安装命令

在目标 Kubernetes 集群中安装 Rainbond，默认会创建 rbd-system 命名空间并部署平台组件。

  • 普通场景可以直接使用默认安装命令。
  • 如果需要自定义网关 IP、外部数据库或镜像仓库，可以通过 -f values.yaml 指定配置。
  • 如果 Containerd socket 不在默认路径，需要在 values.yaml 中配置 Cluster.containerdRuntimePath。
默认安装命令
helm install rainbond rainbond/rainbond --create-namespace -n rbd-system
使用 values.yaml 安装
helm install rainbond rainbond/rainbond --create-namespace -n rbd-system -f values.yaml
执行 Helm 安装

查看安装进度

安装命令执行后，持续查看 rbd-system 命名空间中的 Pod 状态，等待核心组件全部启动完成。

  • 重点关注 rainbond-operator、rbd-api、rbd-app-ui、rbd-gateway 等组件。
  • 当所有 Pod 进入 Running 状态，且 rbd-app-ui 正常运行后，说明安装基本完成。
  • 如果 Pod 长时间 Pending 或 CrashLoopBackOff，可以继续查看 describe 和 logs 定位原因。
查看 Pod 状态
kubectl get pod -n rbd-system
查看安装进度

打开控制台并验证安装结果

安装完成后，在浏览器中打开 Console 地址。如果页面可以正常打开，说明 Helm 安装环境已经可用。

  • 在浏览器访问 http://你的IP:7070。
  • 确认 Rainbond 控制台页面可以正常加载。
  • 如果打不开页面，优先检查主机防火墙、安全组和端口访问策略。
访问 Rainbond 控制台