Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/opstree/dynamic-pv-scaler

A golang based Kubernetes application which can scale volume dynamically
https://github.com/opstree/dynamic-pv-scaler

aws azure dynamic gcp golang hacktoberfest hacktoberfest-accepted kubernetes minikube persistent-volume-claim quay volume-resize

Last synced: about 7 hours ago
JSON representation

A golang based Kubernetes application which can scale volume dynamically

Awesome Lists containing this project

README

        



[![GitHub Super-Linter](https://github.com/opstree/dynamic-pv-scaler/workflows/Lint%20Code%20Base/badge.svg)](https://github.com/opstree/dynamic-pv-scaler)
[![Go Report Card](https://goreportcard.com/badge/github.com/opstree/dynamic-pv-scaler)](https://goreportcard.com/report/github.com/opstree/dynamic-pv-scaler)
[![Maintainability](https://api.codeclimate.com/v1/badges/e60ff968a326babe871f/maintainability)](https://codeclimate.com/github/opstree/dynamic-pv-scaler/maintainability)
[![Docker Repository on Quay](https://img.shields.io/badge/container-ready-green "Docker Repository on Quay")](https://quay.io/repository/opstree/dynamic-pv-scaler)
[![Apache License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/opstree/dynamic-pv-scaler)

## Volume Booster

A golang based Kubernetes application which has been created to overcome the scaling issue of Persistent Volume in Kubernetes. This can scale the Persistent Volume on the basis of threshold which you have set.

## Getting Started

### Architecture



### Pre-requisites

Sorry none of these pre-requisites can be compromised. So you guys have to meet these requirements :slightly_smiling_face:

- Kubernetes cluster version should be greater than 1.11+
- Prometheus should be have the information of Persistent Volume
- In storageclass, *allowVolumeExpansion* flag should be `true`

Example:-

```yaml
---
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: standard
provisioner: kubernetes.io/aws-ebs
parameters:
type: gp2
reclaimPolicy: Retain
allowVolumeExpansion: true # This should be true for every storage class
mountOptions:
- debug
volumeBindingMode: Immediate
```

That's it

### Configuration

We are using helm to maintain the deployment and release in Kubernetes cluster. [Hit Me](./deploy/helm). But for configuration part this application accepts a yaml file `.config.yaml`:

```yaml
---
- namespace: database
scale_percentage: 50
threshold_percentage: 80
pvc_name: data-mysql-0
```

Configuration file overview:-

| **Field** | **Default Value** | **Possible Values** | **Description** |
|-----------|-------------------|---------------------|-----------------|
| namespace | - | *Any valid k8s namespace* | Persistent Volume's namespace which needs to be watched |
| scale_percentage | - | *Any integer* | How much percent you want to scale your pv |
| threshold_percentage | - | *Any integer* | The target percentage after which you want to scale the pv |
| pvc_name | - | *Any valid k8s pvc name* | Name of the pvc which you want to scale |

Make sure you have updated the configuration in [values.yaml](./deploy/helm/values.yaml).

### Installation

Simply use the helm chart to install it on your flavor of Kubernetes.

```shell
# Deploy the PV Scaler
helm upgrade dynamic-pv-scaler ./deploy/helm --install --namespace dynamic-pv-scaler
```

Verify the installation

```shell
helm test dynamic-pv-scaler --namespace dynamic-pv-scaler
kubectl get pods -n dynamic-pv-scaler
```

### Logging

The application's logging interface is designed to print logs in JSON stdout. Example logs:-

![](./static/dynamic-pv-scaler-logging.png)

## Development

Please see our [development documentation](./DEVELOPMENT.md) for details.

## Release

Please see our [release documentation](./CHANGELOG.md) for details.

## Contact

If you have any suggestion or query. Contact us at

[email protected]