DEPRECATED, Direct usage of Cinder Block Storage drivers without the services
Go to file
Gorka Eguileor a9b4466904 Bump version: 0.3.3 → 0.3.4 2019-01-26 16:09:03 +01:00
cinderlib Bump version: 0.3.3 → 0.3.4 2019-01-26 16:09:03 +01:00
docs Document list_installed_drivers 2019-01-24 16:54:41 +01:00
examples/docker Fix #7: Facilitate running example using container 2018-08-29 13:56:26 +02:00
hooks Build stable Rocky container 2019-01-16 14:54:43 +01:00
playbooks Prepare for cinder gate test 2018-09-05 19:54:26 +02:00
tools Update cinderlib 2019-01-14 16:25:18 +01:00
travis-scripts Add LVM CI job 2018-09-06 08:43:28 +02:00
.dockerignore Add Docker images 2018-07-02 19:09:58 +02:00
.gitignore Add LVM CI job 2018-09-06 08:43:28 +02:00
.travis.yml Add LVM CI job 2018-09-06 08:43:28 +02:00
AUTHORS.rst Initial commit 2017-11-03 16:45:13 +01:00
CONTRIBUTING.rst Prepare for cinder gate test 2018-09-05 19:54:26 +02:00
Dockerfile Remove rbd-nbd and improve rbd-ko 2019-01-26 16:07:36 +01:00
Dockerfile-latest Remove rbd-nbd and improve rbd-ko 2019-01-26 16:07:36 +01:00
Dockerfile-release Remove rbd-nbd and improve rbd-ko 2019-01-26 16:07:36 +01:00
HISTORY.rst Remove rbd-nbd and improve rbd-ko 2019-01-26 16:07:36 +01:00
LICENSE Initial commit 2017-11-03 16:45:13 +01:00
MANIFEST.in Initial commit 2017-11-03 16:45:13 +01:00
Makefile Update cinderlib 2019-01-14 16:25:18 +01:00
README docs: Markdown README with RST 2018-07-04 12:51:22 +02:00
README.rst Fix #7: Facilitate running example using container 2018-08-29 13:56:26 +02:00
TODO.rst Change Cinder requirements 2018-08-24 11:24:20 +02:00
requirements_dev.txt Update cinderlib 2019-01-14 16:25:18 +01:00
requirements_docs.txt Update cinderlib 2019-01-14 16:25:18 +01:00
setup.cfg Bump version: 0.3.3 → 0.3.4 2019-01-26 16:09:03 +01:00
setup.py Bump version: 0.3.3 → 0.3.4 2019-01-26 16:09:03 +01:00
tox.ini Update cinderlib 2019-01-14 16:25:18 +01:00

README

# Cinder library

Cinder Library is a Python library that allows using storage drivers outside of
Cinder.

* Free software: Apache Software License 2.0
* Full Documentation: [https://cinderlib.readthedocs.io](https://cinderlib.readthedocs.io).

This library is currently in Alpha stage and is primarily intended as a proof
of concept at this stage.  While some drivers have been manually validated most
drivers have not, so there's a good chance that they could experience issues.

When using this library one should be aware that this is in no way close to the
robustness or feature richness that the Cinder project provides, for detailed
information on the current limitations please refer to the documentation.

Due to the limited access to Cinder backends and time constraints the list of
drivers that have been manually tested are (I'll try to test more):

- LVM with LIO
- Dell EMC XtremIO
- Dell EMC VMAX
- Kaminario K2
- Ceph/RBD
- NetApp SolidFire

If you try the library with another storage array I would appreciate a note on
the library version, Cinder release, and results of your testing.

## Features

* Use a Cinder driver without running a DBMS, Message broker, or Cinder
  service.
* Using multiple simultaneous drivers on the same program.
* Basic operations support:

  - Create volume
  - Delete volume
  - Extend volume
  - Clone volume
  - Create snapshot
  - Delete snapshot
  - Create volume from snapshot
  - Connect volume
  - Disconnect volume
  - Local attach
  - Local detach
  - Validate connector