Skip to main content
Version: v5.3

快速安装

欢迎来到 Rainbond 云原生应用管理的世界!

首先我们先预览一下 Rainbond 的完整安装步骤。

如果您是新用户,希望快速搭建集群尝试,请按照下述流程进行:

  • 准备一台或多台虚拟机或物理机【配置 4GB(内存)/2Core(CPU)/40GB(磁盘) 以上】,安装 ubuntu 16.04 操作系统。
  • 在该节点中安装 Docker,启动 Rainbond All-In-One 控制台。
  • 基于产品引导使用准备的节点安装集群。
  • 集群安装成功即可开始使用。

如果您是搭建生产可用集群,请按照下述流程进行:

  • 规划节点资源和网络拓扑结构。
  • 在第一个节点中装 Docker,启动 Rainbond All-In-One 控制台。
  • 基于产品引导安装 RKE 高可用集群,或对接您通过其他方式准备的高可用 Kubernetes 集群。
  • 准备存储集群(开源方案:GFS、Ceph 等),如果在云上购买分布式存储服务。
  • 配置 Rainbond 集群初始化,对接高可用数据库,高可用存储集群,完成集群初始化。
  • 集群安装成功,在平台中通过应用商店部署 Rainbond 高可用控制台,将 All-In-One 控制台迁移到高可用控制台中。

阅读完上面的信息后,下面让我们开始 Rainbond 的部署:

启动 Rainbond 控制台

如果您是 Rancher 用户,可参考 基于 Rancher 部署 Rainbond 控制台

需要您准备一台可运行 Docker 容器的机器,可以是 Linux、Windows 和 Mac。当然我们推荐使用您准备的 Linux 服务器。如果您还未安装 Docker 服务,可先通过以下命令安装 Docker 服务。

curl sh.rainbond.com/install_docker | bash

请注意,该安装方式仅支持 Linux x86 操作系统。

All-In-One 模式启动控制台

docker run -d -p 7070:7070 -v ~/.ssh:/root/.ssh -v ~/rainbonddata:/app/data \
--name=rainbond-allinone --restart=always \
registry.cn-hangzhou.aliyuncs.com/goodrain/rainbond:v5.3.3-release-allinone

请注意,控制台将产生需要持久化的数据,存储于您部署节点的~/rainbonddata目录中。

All-In-One 控制台默认使用 sqlite3 作为数据库,数据存储于用户主目录下的 rainbonddata 目录。Rainbond 5.3 支持控制台数据迁移,便于后续迁移数据到生产环境,请放心体验。

待容器创建启动成功后,稍等片刻即可访问机器 7070 端口,打开 Rainbond 控制台注册页面。

image-20210219110137479

到此,恭喜您已经完成了第一步,你还需要继续完成集群的部署。

安装或添加 Kubernetes 集群

首次注册完成后将导航到添加集群的页面。Rainbond 需要对接计算资源后即可创建并管理云原生应用。

5.3 版本开始支持直接对接云资源(阿里云 ACK 集群)、已经安装的 Kubernetes 集群资源和用户提供的裸机资源,支持的集群添加方式如下图所示。

image-20210219110808088

  • 1)对接云资源目前适合使用阿里云资源的用户(华为云、腾讯云或其他云用户可自行购买 Kubernetes 服务后使用接入Kubernetes集群方式进行对接)使用云资源方式将自动购买 RDS、ACK、NAS、SLB 等资源,为你快速搭建高可用的生产环境。

    > 使用该方式请注意阅读产品上显示的说明文档,完成账号的权限分配。
  • 2)接入 Kubernetes 集群适合已搭建有 Kubernetes 集群的用户,你应该具有一定的 Kubernetes 管理能力。

    > 使用该方式对接已有 Kubernetes 集群请注意确保使用的 kubeconfig 文件中定义的 KubeApiServer 地址是可被控制台访问的。
    > Kubernetes 版本要求为 1.19.X+。
  • 3)如果你只有 Linux 机器,请使用从主机开始安装入口,Rainbond 为你自动安装 Kubernetes 集群。

    > 使用该方式请注意,请确保所有节点间通信无限制,所有节点可以连接互联网(离线部署模式除外),控制台可以与所有节点进行通信(SSH)。

根据你的实际情况选择对应的方式完成 Kubernetes 集群的添加,添加后集群处于运行中状态即添加成功。

初始化 Rainbond 集群

通过上述三种形式接入的 Kubernetes 集群,若状态满足要求即可选择进行 Rainbond 集群的初始化,Rainbond 集群初始化是指将会在该 Kubernetes 集群中部署 Rainbond Region 端服务,来控制和接管该集群的资源,部署云原生应用。

集群初始化注意事项如下:

  • 若你选择的是已经在使用的 Kubernetes 集群,不要担心,接下来的初始化动作不会影响集群已有的业务形态。

  • Rainbond 集群初始化时默认采用集群中第 1、2 个节点为网关节点和构建节点,你也可以在 Kubernetes 节点上增加 Annotations 来指定对应节点(rainbond.io/gateway-node=true 或 rainbond.io/chaos-node=true)。

  • 网关节点以下端口必须空闲:80, 443, 6060, 8443, 10254, 18080, 18081,否则将导致初始化失败。

  • 集群节点之间网络不能有任何限制,比如个别用户场景节点白名单设定限制了 UDP 通信会导致集群初始化失败。

  • 如果集群节点数量大于 3 将默认安装高可用模式。

  • 安装过程中需要访问网关节点 80、443、6443、8443、6060 端口,请确保相关端口可被访问,比如配置好安全组策略。

  • Rainbond Region 所有服务初始态预计将占用 2GB 内存空间。其中监控服务和数据库资源占用较大。

  • Rainbond 集群初始化时需使用到数据库和分布式存储系统,对于 ACK 集群,Rainbond 将自动购买 RDS 作为集群数据库,购买 NAS 作为默认存储、购买 SLB 作为负载均衡。其他集群默认部署 NFS-Server 和单实例的 Mysql 数据库。若需要自定义配置,请点击集群初始化确认页面的“自定义集群配置参数”。参考文档

确认开始初始化后,初始化过程以产品展示流程为主,集群初始化过程中请不要关闭窗口。

如果集群初始化不成功,比如出现错误:waiting rainbond region ready timeout. 请参考排查文档

控制台迁移

All-In-One 模式部署的控制台不具有生产可用性,体验完成后强烈建议将控制迁移到 Rainbond 中管理 参考文档

离线环境安装

Rainbond 可在离线环境安装和运行,但在源码构建(CI)功能上具有一定的功能损耗,请通过页面下方展示的方式加入 Rainbond 微信群或钉钉群向开发者获取并取得支持。

常见问题

  • Rainbond 支持 ARM CPU 架构部署吗?

Rainbond 企业版支持在华为鲲鹏、飞腾等国产服务器部署,需求请申请企业服务 POC

  • 安装集群时报错 failed to connect to following etcd hosts

该问题属于控制台无法连接报错的节点。首先确定在配置规划集群节点时,正确的对所有节点执行了节点初始化,完成了免密登录设置。检查方式时在控制台容器中执行 ssh docker@节点IP 能够直接免密登录。

如果容器中能正常登录,请检查节点 OpenSSH 的版本,检查方式为 ssh -V, OpenSSH 的版本要求为 OpenSSH 7.0+。如果低于该版本,请升级 OpenSSH 后重试。

  • 初始化 Rainbond 集群时长时间阻塞在 系统所需非组件化镜像本地处理 步骤

通过 kubectl 查询 rbd-system 这个 namespace 下 pod 启动状态,参考 排查文档

其他问题参考排查文档排查解决。或添加 Rainbond 社区钉钉群咨询。