This release is a pre-release and may not be stable for production use.
Simplyblock Control Plane Tooling
Simplyblock is a Kubernetes-native, distributed block storage solution. It was designed from the ground up to be high-performance, NVMe over Fabrics end-to-end, highly available, fault-tolerant, and scalable.
Simplyblock is developed and maintained by Simplyblock.
Documentation
The full simplyblock documentation can be found at docs.simplyblock.io.
Installing the Command Line Interface
The sbctl tooling can be installed using our pypi package sbctl.
pip install --upgrade sbctl
Requires Python 3.9 or newer.
Repository Components
This repository contains the source code for the Simplyblock Control Plane core services and the command line interface
(sbctl).
Technology stack:
- Python
- Docker
- Kubernetes
- FoundationDB
- FastAPI (API v2)
- Flask (API v1)
- OpenAPI (Swagger)
The repository is split into the following components:
Simplyblock Core
The simplyblock_core/ directory contains the core logic and controllers for a simplyblock control plane cluster.
Simplyblock CLI
The simplyblock_cli directory contains the sbctl command line interface code. A full list of the available command
line interface commands and options can be found in the sbctl reference.
Commands and options in the command line interface are implemented using an automatic generator and a YAML definitions
file (simplyblock_cli/sbctl/cli-reference.yaml). For well-conformity of the YAML file, a schema definition is
provided in simplyblock_cli/sbctl/cli-reference-schema.json and linked on top of the reference for immediate use
in Visual Studio Code and IntelliJ-based platforms.
If commands or options are added, updated, or removed, the YAML file, the generator must be executed to update the
startup code of sbctl.
tox run -e generate
Executing this command updates simplyblock_cli/cli.py according to the reference file.
Reference Notes
There are a few implicit rules in the reference file:
- Positional Argument: Arguments without leading hyphens (
--or-) are considered positional arguments which are always required. - Optional Argument: Arguments with leading hyphens (
--or-) are considered optional arguments except marked asrequired: true. - Naming Convention Commands: When commands and subcommands are added, the generator creates the function names according to the following naming convention
<command>__<subcommand>which has to be implemented inclibase.py. If the command or subcommand contains a hyphen in the name, it is exchanged for an underscore.
Simplyblock Web API
The simplyblock_web directory contains the source code for the simplyblock control plane API. A full list of the
available API endpoints and options can be found in the API reference.
Notes on Local Development
FoundationDB
Simplyblock's control plane uses FoundationDB, which means it requires a FDB client library (libfdb_c.dylib) for the Python bindings to interact with the database.
Depending on the OS architecture, the appropriate version must be installed from their official github repo.
wget https://github.com/apple/foundationdb/releases/download/7.3.3/FoundationDB-7.3.3_arm64.pkg
Docker Compose
A local development environment can be spun up using the Docker compose file: docker-compose-dev.yml.
sudo docker compose -f docker-compose-dev.yml up --build -d
License
Copyright (c) 2021-2025 Simplyblock GmbH. All rights reserved.
4 maintainers
Metadata
4 maintainers
Release files for sbctl 26.4.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sbctl-26.4.0b1.tar.gz | 1.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sbctl-26.4.0b1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.3 MB
Release files / sbctl-26.4.0b1.tar.gz
| Download URL | sbctl-26.4.0b1.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5d3996f22d7d3709279b178c5ef4531bcbe13b6300dd30703d1c9064ca187efb
|
|
BLAKE2b-256 checksum How to use checksums |
fe7a857aedc6763c667dde95c00e750e62584d25ef6d54839be289a13af47318
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / sbctl-26.4.0b1-py3-none-any.whl
| Download URL | sbctl-26.4.0b1-py3-none-any.whl |
|---|---|
| Size | 1.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
71b19598934f6c4fd981b4f23c572d2461cbda1cfc3ac4c2d448eb42d9ba29f4
|
|
BLAKE2b-256 checksum How to use checksums |
ac060c3a24cc8fee8c447bba4024b382da38f903b14b4190d1d67daf430da6be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
