Skip to main content

Based on self-built Kubernetes installation

Summarize

This article will guide you through the Helm command to quickly deploy Rainbond based on your existing Kubernetes cluster.

Precondition

Install Rainbond

1. Install the NFS client mounting tool

During the default installation, Rainbond starts an NFS-Provisioner; therefore, an NFS client mounting tool needs to be installed on the node, otherwise the installation will fail due to an inability to mount storage. If you customize the configuration, use external shared storage. Then this step can be ignored.

yum -y install nfs-utils

2. Add and update Helm repository

helm repo add rainbond https://openchart.goodrain.com/goodrain/rainbond
helm repo update
kubectl create namespace rbd-system

3. Install Rainbond

Rainbond supports both Docker and Containerd container runtimes. When a cluster environment has both Docker and Containerd installed, Docker is used by default. You can specify the actual container runtimes through the environment variables.

helm install rainbond rainbond/rainbond-cluster -n rbd-system

If you have a Cluster of public IP, you need to access from outside, please specify Cluster. GatewayIngressIPs parameters, as shown below, will command the gatewayIngressIPs replace your public IP can:

helm install --set Cluster.gatewayIngressIPs=47.96.3.163 rainbond rainbond/rainbond-cluster -n rbd-system 

4. Installation progress query

After the installation command is executed, run the following command in the cluster to check the installation status.

watch kubectl get po -n rbd-system

The installation is successful when the Pod with the name rdb-app-ui is in the Running state. If Pod rdd-app-UI-669BB7C74B-7BMLf is in the Running state, Rainbond is installed successfully.

Installation result
NAME                                         READY   STATUS      RESTARTS   AGE
nfs-provisioner-0 1/1 Running 0 14d
rbd-etcd-0 1/1 Running 0 14d
rbd-hub-64777d89d8-l56d8 1/1 Running 0 14d
rbd-gateway-76djb 1/1 Running 0 14d
dashboard-metrics-scraper-7db45b8bb4-tcgxd 1/1 Running 0 14d
rbd-mq-6b847d874b-j5jg2 1/1 Running 0 14d
rbd-webcli-76b54fd7f6-jrcdj 1/1 Running 0 14d
kubernetes-dashboard-fbd4fb949-2qsn9 1/1 Running 0 14d
rbd-resource-proxy-547874f4d7-dh8bv 1/1 Running 0 14d
rbd-monitor-0 1/1 Running 0 14d
rbd-db-0 2/2 Running 0 14d
rbd-eventlog-0 1/1 Running 0 14d
rbd-app-ui-669bb7c74b-7bmlf 1/1 Running 0 7d12h
rbd-app-ui-migrations--1-hp2qg 0/1 Completed 0 14d
rbd-worker-679fd44bc7-n6lvg 1/1 Running 0 9d
rbd-node-jhfzc 1/1 Running 0 9d
rainbond-operator-7978d4d695-ws8bz 1/1 Running 0 9d
rbd-chaos-nkxw7 1/1 Running 0 8d
rbd-api-5d8bb8d57d-djx2s 1/1 Running 0 47h

5. Access platform

Run the following command in the cluster to obtain the platform access address. If there are multiple gateway nodes, the console can be accessed from any one address.

kubectl get rainbondcluster rainbondcluster -n rbd-system -o go-template --template='{{range.spec.gatewayIngressIPs}}{{.}}:7070{{printf "\n"}}{{end}}'

6. Customize Advanced Settings (Optional)

When you have some additional requirements, such as using self-built mirror repositories, databases, ETCD, StorageClass, specifying gateway nodes, specifying build nodes, etc. You can generate the installation command using Helm Installation Command Generator tool. Parameters in detail can refer to values. Yaml explanation

Problem troubleshooting

The installation process if not finished for long time, so please refer to the document Helm installation problem troubleshooting guide, for troubleshooting. Use can reference Rainbond use screen or join WeChat group, nailing group Ask for help.

Next step

See quick start to deploy your first app.