Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/topolvm/topolvm

Capacity-aware CSI plugin for Kubernetes
https://github.com/topolvm/topolvm

csi kubernetes lvm2

Last synced: 1 day ago
JSON representation

Capacity-aware CSI plugin for Kubernetes

Host: GitHub
URL: https://github.com/topolvm/topolvm
Owner: topolvm
License: apache-2.0
Created: 2019-04-26T04:30:56.000Z (almost 6 years ago)
Default Branch: main
Last Pushed: 2024-10-25T00:36:06.000Z (3 months ago)
Last Synced: 2024-10-29T20:50:32.601Z (3 months ago)
Topics: csi, kubernetes, lvm2
Language: Go
Homepage:
Size: 17.4 MB
Stars: 809
Watchers: 22
Forks: 159
Open Issues: 19
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS

Awesome Lists containing this project

awesome-cloud-native - TopoLVM - Capacity-aware CSI plugin for Kubernetes. (Storage)

README

        ![TopoLVM logo](./docs/img/TopoLVM_logo.svg)

[![GitHub release](https://img.shields.io/github/v/release/topolvm/topolvm.svg?maxAge=60)][releases]

[![Main](https://github.com/topolvm/topolvm/workflows/Main/badge.svg)](https://github.com/topolvm/topolvm/actions)

[![PkgGoDev](https://pkg.go.dev/badge/github.com/topolvm/topolvm?tab=overview)](https://pkg.go.dev/github.com/topolvm/topolvm?tab=overview)

[![Go Report Card](https://goreportcard.com/badge/github.com/topolvm/topolvm)](https://goreportcard.com/badge/github.com/topolvm/topolvm)

# TopoLVM

TopoLVM is a [CSI][] plugin using LVM for Kubernetes.

It can be considered as a specific implementation of [local persistent volumes](https://kubernetes.io/docs/concepts/storage/volumes/#local) using CSI and LVM.

- **Conformed CSI version**: [1.5.0](https://github.com/container-storage-interface/spec/blob/v1.5.0/spec.md)

Our supported platform are:

- Kubernetes: 1.31, 1.30, 1.29,

- Node OS: Linux with LVM2 (\*1), specifically tested on Ubuntu

- CPU Architecture: x86 (\*2), arm64 (\*3), ppc64le (\*3), s390x (\*4)

- Filesystems: ext4, xfs, btrfs\[beta(\*5)\]

- lvm version 2.02.163 or later (adds JSON output support)

\*1 The host's Linux Kernel must be v4.9 or later which supports `rmapbt` and `reflink`, if you use xfs filesystem with an official docker image.  

\*2 Tier1 support. The official docker images are provided and all functionalities are tested by CI.  

\*3 Tier2 support. The official docker images are provided, but no tests run by CI.  

\*4 Tier3 support. No docker images are provided, and no tests run by CI, but binaries are built.  

\*5 btrfs is in beta as of v0.31.0. It can be used in production, but has not seen extensive use by our users yet.

Docker images are available on [ghcr.io](https://github.com/orgs/topolvm/packages).  

## Getting Started

If you want to try TopoLVM on your local machine, see [example](example/) directory which provides scripts to run TopoLVM on [kind (Kubernetes IN Docker)][kind].

To use TopoLVM on your real kubernetes cluster, read [documents](docs/README.md).

Deprecated: If you want to use TopoLVM on [Rancher/RKE](https://rancher.com/docs/rke/latest/en/), see [docs/deprecated/rancher/README.md](docs/deprecated/rancher/README.md).

## Contributing

TopoLVM project welcomes contributions from any member of our community. To get

started contributing, please see our [Contributing Guide](CONTRIBUTING.md).

## Scope

### In Scope

- [Dynamic provisioning](https://kubernetes-csi.github.io/docs/external-provisioner.html): Volumes are created dynamically when `PersistentVolumeClaim` objects are created.

- [Raw block volume](https://kubernetes-csi.github.io/docs/raw-block.html): Volumes are available as block devices inside containers.

- [Topology](https://kubernetes-csi.github.io/docs/topology.html): TopoLVM uses CSI topology feature to schedule Pod to Node where LVM volume exists.

- Extended scheduler: TopoLVM extends the general Pod scheduler to prioritize Nodes having larger storage capacity.

- Volume metrics: Usage stats are exported as Prometheus metrics from `kubelet`.

- [Volume Expansion](https://kubernetes-csi.github.io/docs/volume-expansion.html): Volumes can be expanded by editing `PersistentVolumeClaim` objects.

- [Storage capacity tracking](https://github.com/topolvm/topolvm/tree/main/deploy#storage-capacity-tracking): You can enable Storage Capacity Tracking mode instead of using topolvm-scheduler.

- [Snapshot](https://kubernetes-csi.github.io/docs/snapshot-restore-feature.html): Snapshots can be taken when using thin provisioning.

### Planned Features

- Prioritize based on volume capacity without using the extended scheduler.

## Communications

If you have any questions or ideas, please use [discussions](https://github.com/topolvm/topolvm/discussions).

## Resources

[docs](docs/) directory contains the user manual, designs and specifications, and so on.

A diagram of components is available in [docs/design.md](docs/design.md#diagram).

TopoLVM maintainers presented the motivation and implementation of TopoLVM at KubeCon Europe 2020: https://kccnceu20.sched.com/event/ZerD

## License

This project is licensed under [Apache License 2.0](LICENSE).

[releases]: https://github.com/topolvm/topolvm/releases

[CSI]: https://github.com/container-storage-interface/spec

[kind]: https://github.com/kubernetes-sigs/kind