Quick Start with yaml files
Start kadalu operator
$ kubectl apply -f https://github.com/kadalu/kadalu/releases/latest/download/kadalu-operator.yaml
$ kubectl apply -f https://github.com/kadalu/kadalu/releases/latest/download/csi-nodeplugin.yaml
You have different flavors of operator yaml files available. Mainly for kubernetes (default), openshift, RKE, Microk8s. Find the relevant file from here. Just remember to use the raw file as argument to kubectl
.
Note: Openshift may have some Security Context Constraints, which can be applied only by admins, Run oc login -u system:admin
to login as admin.
Prepare and start storage exports
Identify the devices available from nodes and run the following command to add storage to Kadalu.
$ kubectl get nodes
kube1 # <-- known your hostname, which needs to be given in storage config below.
...
...
Note
|
if your host is running RHEL/CentOS 7.x series or Ubuntu/Debian older than 18.04, you may need to do below tasks before adding storage to kadalu. |
# On CentOS7.x/Ubuntu-16.04 sudo wipefs -a -t dos -f /dev/sdc sudo mkfs.xfs /dev/sdc
Once the device is ready, inform the kadalu operator that it can be used as storage.
# File: sample-storage-config.yaml
---
apiVersion: kadalu-operator.storage/v1alpha1
kind: KadaluStorage
metadata:
# This will be used as name of PV Hosting Volume
name: storage-pool-1
spec:
type: Replica1
storage:
- node: kube1
device: /dev/sdc
$ kubectl apply -f sample-storage-config.yaml
Other than device
, kadalu also supports path
and pvc
as storage options.
kadalu supports Replica1
, Replica2
and Replica3
type. This maps to glusterfs volume replication feature. It also support External
as a type, where gluster volume may be managed externally, and kadalu is used to provide only CSI access.
Check status
Operator will start the storage export pods as required. And, in 2 steps, your storage system is up and running.
Check the status of Pods using,
$ kubectl get pods -n kadalu
NAME READY STATUS RESTARTS AGE
server-storage-pool-1-kube1-0 1/1 Running 0 84s
csi-nodeplugin-5hfms 3/3 Running 0 30m
csi-nodeplugin-924cc 3/3 Running 0 30m
csi-nodeplugin-cbjl9 3/3 Running 0 30m
csi-provisioner-0 5/5 Running 0 30m
operator-6dfb65dcdd-r664t 1/1 Running 0 30m
After this, go ahead and create your PVC and attach it to other applications.