/ k8s-storage / latest / quick-start-yaml/

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.

© 2021 Kadalu Software Private Limited. All Rights Reserved.