Everything you need to run simplyblock — high-performance NVMe/TCP block storage — natively on Kubernetes
📖 Read the full documentation at docs.simplyblock.io
This repository is the home of simplyblock's Kubernetes integration. It bundles the operator, the CSI driver, the shared node-level storage library, and the Helm charts that deploy them — so the whole stack is developed, versioned, built, and released together from a single source tree.
Simplyblock delivers enterprise-grade, software-defined block storage to Kubernetes over NVMe-over-TCP: ultra-low latency, snapshots, clones, erasure coding, multi-tenancy, and QoS — without specialized hardware or vendor lock-in.
👉 For the supported, end-to-end installation flow, see the Simplyblock Kubernetes Deployment Guide.
| Component | Path | Description |
|---|---|---|
| Operator | operator/ |
Kubernetes operator for declarative lifecycle management of simplyblock storage clusters, nodes, pools, backups, and replication via Custom Resources. |
| CSI Driver | csi-driver/ |
Container Storage Interface driver that provisions and attaches NVMe/TCP volumes to workloads (dynamic provisioning, snapshots, clones, QoS). |
| Atlas Library | atlas-lib/ |
Shared Go library holding the node-level storage primitives (NVMe discovery, NVMe-oF fabric management, lvol↔device mapping) that both the operator and CSI driver depend on. |
| Helm Charts | helm-charts/ |
Official Helm charts that deploy the operator, CSI driver, and supporting components onto Kubernetes. |
Each component has its own README with focused documentation.
Simplyblock is installed as a whole via the official Helm charts, following the documentation. The guide wires up the control plane, the operator, cert-manager, and the CSI driver together:
👉 Simplyblock Kubernetes Deployment Guide
For component-specific installation and development notes, see each component's README linked above.
The root Makefile orchestrates builds and tests across every component, delegating to
each component's own Makefile:
make build # Build every component (atlas, csi, operator) and sync CRDs into the Helm chart
make test # Test every component
make lint # Lint every component
make help # List all available targetsIndividual components can be built directly, e.g. make operator-build or make csi-test. See
make help for the full list.
This project is licensed under the Apache 2.0 License — see the LICENSE file for details.
Contributions are welcome! Please read CONTRIBUTING.md for guidelines on reporting issues, submitting pull requests, and coding conventions.
Maintained by the simplyblock team.
Manage NVMe-grade simplyblock storage the Kubernetes-native way.