Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kadalu/kadalu

A lightweight Persistent storage solution for Kubernetes / OpenShift / Nomad using GlusterFS in background. More information at https://kadalu.tech
https://github.com/kadalu/kadalu

arm64 csi csi-driver gluster glusterfs heketi helm-chart k3s k8s k8s-sig-storage kubernetes kubernetes-sig-storage microk8s nomad openshift-storage operator rancher rke rook storage

Last synced: about 1 month ago
JSON representation

A lightweight Persistent storage solution for Kubernetes / OpenShift / Nomad using GlusterFS in background. More information at https://kadalu.tech

Host: GitHub
URL: https://github.com/kadalu/kadalu
Owner: kadalu
License: other
Created: 2019-07-10T15:31:42.000Z (over 5 years ago)
Default Branch: devel
Last Pushed: 2024-04-12T13:43:25.000Z (7 months ago)
Last Synced: 2024-04-14T09:04:39.803Z (7 months ago)
Topics: arm64, csi, csi-driver, gluster, glusterfs, heketi, helm-chart, k3s, k8s, k8s-sig-storage, kubernetes, kubernetes-sig-storage, microk8s, nomad, openshift-storage, operator, rancher, rke, rook, storage
Language: Python
Homepage: https://docs.kadalu.tech/k8s-storage/devel/quick-start/
Size: 1.95 MB
Stars: 689
Watchers: 21
Forks: 95
Open Issues: 61
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

# kaDalu

[![Operator Docker Pulls](https://img.shields.io/docker/pulls/kadalu/kadalu-operator.svg?label=DockerPulls%20Operator)](https://img.shields.io/docker/pulls/kadalu/kadalu-operator.svg)
[![Server Docker Pulls](https://img.shields.io/docker/pulls/kadalu/kadalu-server.svg?label=DockerPulls%20Server)](https://img.shields.io/docker/pulls/kadalu/kadalu-server.svg)
![Devel](https://github.com/kadalu/kadalu/actions/workflows/on-pr-merge.yml/badge.svg)
![Release](https://github.com/kadalu/kadalu/actions/workflows/on-release-tag.yml/badge.svg)

## What is Kadalu ?

[Kadalu](https://kadalu.io) is a project to provide Persistent Storage in container ecosystem (like kubernetes, openshift, RKE, etc etc). Kadalu operator deploys CSI pods, and **gluster storage** pods as per the config. You would get your PVs served through APIs implemented in CSI.

## Get Started

Getting started is made easy to copy paste the below commands.

```console
curl -fsSL https://github.com/kadalu/kadalu/releases/latest/download/install.sh | sudo bash -x
kubectl-kadalu version
kubectl kadalu install --type=$K8S_DIST
```

Where `K8S_DIST` can be one of below values and `kubernetes` being the default:
- kubernetes
- openshift
- rke
- microk8s

The above will deploy the latest version of kadalu operator and CSI pods. Once done, you can provide storage to kadalu operator to manage.

```
$ kubectl kadalu storage-add storage-pool-1 --device kube1:/dev/sdc
```

Note that, in above command, `kube1` is the node which is providing `/dev/sdc` as a storage to kadalu. In your setup, this may be different.

If you made some errors in setup, and want to start fresh, check this [cleanup script](extras/scripts/cleanup), and run it to remove kadalu namespace completely.

```
curl -s https://raw.githubusercontent.com/kadalu/kadalu/devel/extras/scripts/cleanup | bash
```

## Reach out

1. Best is opening an [issue in github.](https://github.com/kadalu/kadalu/issues)
2. Reach to us on [Slack](https://join.slack.com/t/kadalu/shared_invite/enQtNzg1ODQ0MDA5NTM2LWMzMTc5ZTJmMjk4MzI0YWVhOGFlZTJjZjY5MDNkZWI0Y2VjMDBlNzVkZmI1NWViN2U3MDNlNDJhNjE5OTBlOGU) (Note, there would be no history) - https://kadalu.slack.com

## Contributing

We would like your contributions to come as feedbacks, testing, development etc. See [CONTRIBUTING](CONTRIBUTING.md) for more details.

If you are interested in financial donation to the project, or to the developers, you can do so at our [opencollective](https://opencollective.com/kadalu) page. (We like github sponsors too, but its still in waiting list for an org in India).

## Helm support

`helm install kadalu --namespace kadalu --create-namespace https://github.com/kadalu/kadalu/releases/latest/download/kadalu-helm-chart.tgz --set-string kubernetesDistro=$K8S_DIST`

Where `K8S_DIST` can be one of below values:
- kubernetes
- openshift
- rke
- microk8s

If `--set-string` isn't supplied `kubernetes` will be used as default.

NOTE: We are still evolving with Helm chart based development, and happy to get contributions on the same.

## Platform supports

We support x86_64 (amd64) by default (all releases, `devel` and `latest` tags), and from release 0.8.3 tag arm64 and arm/v7 is supported.

For any other platforms, we need users to confirm it works by building images locally. Once it works, we can include it in our automated scripts. You can confirm the build by command `make release` after checkout of the repository in the respective platform.

## How to pronounce kadalu ?

One is free to pronounce 'kaDalu' as they wish. Below is a sample of how we pronounce it!

[](https://raw.githubusercontent.com/kadalu/kadalu/devel/extras/assets/kadalu_01.wav)

>
>**Request:** If you like the project, give a github star :-)
>