Kubestr is a collection of tools to discover, validate and evaluate your kubernetes storage options.

Kubestr was introduced recently to solve the problem of choosing the right storage solution for your kubernetes cluster. Running workloads that need persistence storage is not new and the use of it is ever increasing.

There are different persistence storage solutions based on CSI that have grown over time, with CSI different storage vendors have created the drivers that are used by the community.

Below is the image from CNCF Landscape showing the number of cloud-native storage options available at the time of writing.

Cloud native storage

So Kubestr aims to solve the following challenges: - Identify the various storage options present in a cluster. - Validate if the storage options are configured correctly. - Evaluate the storage using common benchmarking tools like FIO.

When you pick the storage option for your cluster it can be difficult to choose from so many vendors, whilst also benchmarking them to see if they are actually good for your use case.

It is important to check if the storage solution is configured correctly, which is where Kubestr can help. In this post we will discover what Kubestr brings to the table and explore the Longhorn storage solution.

Step 1: Create Civo Kubernetes cluster with Longhorn installed

Naturally, we'll use Civo Kubernetes, which is based on K3s, to experiment with this quickly. If you don’t yet have an account, sign up here. You could also use any other Kubernetes cluster you have access to.

Create a new cluster from the UI (you can also use Civo CLI), then install Longhorn from the Marketplace.

Creating a cluster on Civo

Once ready you should see the cluster with ready nodes.

Cluster is ready

Make sure you have kubectl installed, and the kubeconfig file for your cluster downloaded.

kubectl get nodes
NAME                                        STATUS   ROLES                  AGE     VERSION
k3s-sotrage-longhorn-819c2694-master-4135   Ready    control-plane,master   6h30m   v1.20.2+k3s1
k3s-sotrage-longhorn-819c2694-node-ad87     Ready    <none>                 6h30m   v1.20.2+k3s1
k3s-sotrage-longhorn-819c2694-node-ee0f     Ready    <none>                 6h30m   v1.20.2+k3s1

Alternatively you can install Longhorn via a kubectl command as well:

kubectl apply -f https://raw.githubusercontent.com/longhorn/longhorn/v1.0.0/deploy/longhorn.yaml

Step 2: Install Kubestr locally

Here we will install Kubestr on a Mac by running curl -LO https://github.com/kastenhq/kubestr/releases/download/v0.4.13/kubestr-v0.4.13-darwin-amd64.tar.gz


tar -xvf kubestr-v0.4.13-darwin-amd64.tar.gz
x kubestr

Step 3: Experimenting Kubernetes Storage with Kubestr

Check if Kubestr is running

$ kubestr -h       
kubestr is a tool that will scan your k8s cluster
        and validate that the storage systems in place as well as run
        performance tests.

  kubestr [flags]
  kubestr [command]

Available Commands:
  csicheck    Runs the CSI snapshot restore check
  fio         Runs an fio test
  help        Help about any command

  -h, --help            help for kubestr
  -o, --output string   Options(json)

Storage solutions enabled on the cluster

Let's check the storage options enabled on the cluster by running the kubestr command

Kubestr in action

In our case we have local-path provisioner that comes pre-installed for K3s and the other one is Longhorn that we installed.

Checking the Snapshot backup/restore functionality

This is a really handy feature that can help you to find out whether the Backup/restore will work for your persistent volume

To enable this you need to deploy the snapshot CRD's, snapshot controller and setup a backup target in Longhorn.

Install the Snapshot Beta CRDs

Download the files from https://github.com/kubernetes-csi/external-snapshotter/tree/master/client/config/crd

Run kubectl create -f client/config/crd and it should get applied to your cluster, which you can see by running:

kubectl get crd | grep snapshot
volumesnapshotclasses.snapshot.storage.k8s.io    2021-03-31T14:12:57Z
volumesnapshotcontents.snapshot.storage.k8s.io   2021-03-31T14:13:22Z
volumesnapshots.snapshot.storage.k8s.io          2021-03-31T14:13:48Z

Install the Common Snapshot Controller

Download the files from https://github.com/kubernetes-csi/external-snapshotter/tree/master/deploy/kubernetes/snapshot-controller

Update the namespace to an appropriate value for your environment (e.g. kube-system) Run kubectl create -f deploy/kubernetes/snapshot-controller.

kubectl get pods -n kube-system | grep snapshot
snapshot-controller-9f68fdd9-ghpk7        1/1     Running   0          6m14s
snapshot-controller-9f68fdd9-9rrww        1/1     Running   0          6m14s

Now create the CR by creating a yaml file with the below details:

kind: VolumeSnapshotClass
apiVersion: snapshot.storage.k8s.io/v1beta1
  name: longhorn
driver: driver.longhorn.io
deletionPolicy: Delete

Now when you run kubestr you can see the snapshot appear

Snapshots in Kubestr

Setting the Backup target in Longhorn, we will install minio to the cluster and use that as the target.

kubectl create -f https://raw.githubusercontent.com/longhorn/longhorn/master/deploy/backupstores/minio-backupstore.yaml

secret/minio-secret created
secret/minio-secret created
pod/longhorn-test-minio created
service/minio-service created

kubectl get secrets| grep minio
NAME                  TYPE                                  DATA   AGE
minio-secret          Opaque                                5      4m6s

Open the Longhorn-frontend and set as below in the in the settings page

Longhorn settings

Let's check if the snapshot and restore is working with Longhorn

./kubestr csicheck -s longhorn -v longhorn

Above command does the following

Volume snapshotting process illustration

Longhorn backup details

Longhorn backup details 2

Longhorn backup status

Output from the command will look something like:

Creating application
  -> Created pod (kubestr-csi-original-pod6qkj8) and pvc (kubestr-csi-original-pvcphtb2)
Taking a snapshot
  -> Created snapshot (kubestr-snapshot-20210402193113)
Restoring application
  -> Restored pod (kubestr-csi-cloned-podckmtt) and pvc (kubestr-csi-cloned-pvcnstz7)
Cleaning up resources
CSI checker test:
CSI application successfully snapshotted and restored.  -  OK

This would help to check if the storage solution is implemented correctly and the snapshot/backup and restore will work.

Storage Performance evaluation

This feature for Kubestr let you test the performance of the storage by using the standard fio, you can also use your own fio configs. Let's test it against our cluster

./kubestr fio --help
Run an fio test

  kubestr fio [flags]

  -f, --fiofile string        The path to a an fio config file.
  -h, --help                  help for fio
  -i, --image string          The container image used to create a pod.
  -n, --namespace string      The namespace used to run FIO. (default "default")
  -z, --size string           The size of the volume used to run FIO. (default "100Gi")
  -s, --storageclass string   The name of a Storageclass. (Required)
  -t, --testname string       The Name of a predefined kubestr fio test. Options(default-fio)

Global Flags:
  -o, --output string   Options(json)

Let's run the test with 10G size ./kubestr fio -s longhorn -z 10G

10Gi volume created

Output of the command

PVC created kubestr-fio-pvc-rs8vw
Pod created kubestr-fio-pod-9llqr
Running FIO test (default-fio) on StorageClass (longhorn) with a PVC of Size (10G)
Elapsed time- 3m32.957323713s
FIO test results:

FIO version - fio-3.20
Global options - ioengine=libaio verify=0 direct=1 gtod_reduce=1

JobName: read_iops
  blocksize=4K filesize=2G iodepth=64 rw=randread
  IOPS=17.528746 BW(KiB/s)=79
  iops: min=4 max=189 avg=39.736843
  bw(KiB/s): min=16 max=759 avg=159.894730

JobName: write_iops
  blocksize=4K filesize=2G iodepth=64 rw=randwrite
  IOPS=9.270335 BW(KiB/s)=46
  iops: min=2 max=103 avg=41.090908
  bw(KiB/s): min=8 max=415 avg=164.909088

JobName: read_bw
  blocksize=128K filesize=2G iodepth=64 rw=randread
  IOPS=22.611294 BW(KiB/s)=3228
  iops: min=3 max=238 avg=50.349998
  bw(KiB/s): min=510 max=30464 avg=6484.799805

JobName: write_bw
  blocksize=128k filesize=2G iodepth=64 rw=randwrite
  IOPS=11.329676 BW(KiB/s)=1809
  iops: min=1 max=198 avg=50.400002
  bw(KiB/s): min=255 max=25344 avg=6501.600098

Disk stats (read/write):
  sda: ios=1206/608 merge=6/46 ticks=3526454/3399757 in_queue=6922544, util=97.771729%
  -  OK

Wrapping Up

Kubestr is a simple lightweight tool to evaluate storage options within your cluster. You can run it across multiple clusters by changing the Kubeconfig and compare the performance across cluster, clouds and storage options.

Let us know on Twitter @Civocloud and @SaiyamPathak if you try Kubestr to evaluate Longhorn on Civo Kubernetes!