返回视频教程列表
安装部署 / 已有 K8s 集群
已有 K8s 集群上用 Helm 安装
在已有 Kubernetes 集群中添加 Rainbond Helm 仓库，执行 Helm 安装并验证控制台访问。
时长 00:51预计操作 8 分钟已经有 Kubernetes 集群、希望通过 Helm 安装 Rainbond 的用户
Helm 安装Kubernetes
点击封面后将在新窗口打开 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 控制台