openstack/cinderlib
Code Issues Proposed changes
Files
37c085fd6c63f01a6891be4cc55124eee90bed68
cinderlib/devstack
History
Gorka Eguileor 37c085fd6c Add DevStack plugin 
This patch adds a DevStack plugin to cinderlib so it can be installed
directly by DevStack and used for CI jobs as well as development.

When installing it will also get the Cinder configuration and generate a
.py file with the right initialization of the different backends that
have been configured in /etc/cinder/cinder.conf by the DevStack Cinder
job and its plugins.

Change-Id: I12f6b0e1bc047f1915e4f7532ea59495477f9b4a
2019-03-20 18:34:16 +01:00
..
override-defaults
Add DevStack plugin
2019-03-20 18:34:16 +01:00
plugin.sh
Add DevStack plugin
2019-03-20 18:34:16 +01:00
README.rst
Add DevStack plugin
2019-03-20 18:34:16 +01:00
settings
Add DevStack plugin
2019-03-20 18:34:16 +01:00

README.rst

Cinderlib DevStack Plugin

This directory contains the cinderlib DevStack plugin.

To configure cinderlib with DevStack, you will need to enable this plugin by adding one line to the local section of your local.conf file.

To enable the plugin, add a line of the form:

enable_plugin cinderlib <GITURL> [GITREF]

where:

<GITURL> is the URL of a cinderlib repository
[GITREF] is an optional git ref (branch/ref/tag).  The default is master.

For example:

enable_plugin cinderlib https://git.openstack.org/openstack/cinderlib

Another example using Stein's stable branch:

enable_plugin cinderlib https://git.openstack.org/openstack/cinderlib stable/stein

The cinderlib DevStack plugin will install cinderlib from Git by default, but it can be installed from PyPi using the CINDERLIB_FROM_GIT configuration option:

CINDERLIB_FROM_GIT=False

The plugin will also generate the code equivalent to the deployed Cinder's configuration in $CINDERLIB_SAMPLE_DIR/cinderlib.py which defaults to the same directory where the Cinder configuration is saved.

For more information, see the DevStack plugin documentation.