Juju Charm - Cinder LVM backend
Go to file
Alex Kavanagh caf0b11a4d Update to build using charmcraft
Due to a build problem with the reactive plugin, this change falls back
on overriding the steps and doing a manual build, but it also ensures
the CI system builds the charm using charmcraft.  Changes:

- add a build-requirements.txt
- modify charmcraft.yaml
- modify osci.yaml
    -> indicate build with charmcraft
- modify tox.ini
    -> tox -e build does charmcraft build/rename
    -> tox -e build-reactive does the reactive build
- modify bundles to use the <charm>.charm artifact in tests.
  and fix deprecation warning re: prefix
- tox inception to enable tox -e func-test in the CI

Change-Id: I5f6f7c7e281202e44d2f13e7478d04b6fcb93016
2022-02-01 19:47:58 +00:00
src Update to build using charmcraft 2022-02-01 19:47:58 +00:00
unit_tests Change config parameter 'backend-name' to 'volume-backend-name' 2021-10-19 18:59:12 -03:00
.gitignore Curate the cinder-lvm charm 2021-09-30 17:43:33 -03:00
.gitreview Curate the cinder-lvm charm 2021-09-30 17:43:33 -03:00
.stestr.conf Initial Cookiecutter Commit. 2020-08-03 17:13:40 -03:00
.zuul.yaml Change config parameter 'backend-name' to 'volume-backend-name' 2021-10-19 18:59:12 -03:00
build-requirements.txt Update to build using charmcraft 2022-02-01 19:47:58 +00:00
charmcraft.yaml Update to build using charmcraft 2022-02-01 19:47:58 +00:00
copyright Curate the cinder-lvm charm 2021-09-30 17:43:33 -03:00
metadata.yaml Curate the cinder-lvm charm 2021-09-30 17:43:33 -03:00
osci.yaml Update to build using charmcraft 2022-02-01 19:47:58 +00:00
pip.sh Curate the cinder-lvm charm 2021-09-30 17:43:33 -03:00
README.md Curate the cinder-lvm charm 2021-09-30 17:43:33 -03:00
rename.sh Update to build using charmcraft 2022-02-01 19:47:58 +00:00
requirements.txt Change config parameter 'backend-name' to 'volume-backend-name' 2021-10-19 18:59:12 -03:00
test-requirements.txt Add yoga bundles and release-tool syncs 2021-11-17 13:50:13 -05:00
tox.ini Update to build using charmcraft 2022-02-01 19:47:58 +00:00

Overview

The cinder-lvm charm provides an LVM backend for Cinder, the core OpenStack block storage (volume) service. It is a subordinate charm that is used in conjunction with the cinder charm.

Note

: The cinder-lvm charm is supported starting with OpenStack Queens.

Usage

Configuration

This section covers common and/or important configuration options. See file config.yaml for the full list of options, along with their descriptions and default values. See the Juju documentation for details on configuring applications.

allocation-type

Refers to volume provisioning type. Values can be 'thin', 'thick', 'auto' (resolves to 'thin' if supported) , and 'default' (resolves to 'thick'). The default value is 'default'.

block-device

Specifies a space-separated list of devices to use for LVM physical volumes. This is a mandatory option. Value types include:

  • block devices (e.g. 'sdb' or '/dev/sdb')
  • a path to a local file with the size appended after a pipe (e.g. '/path/to/file|10G'). The file will be created if necessary and be mapped to a loopback device. This is intended for development and testing purposes. The default size is 5G.

To prevent potential data loss an already formatted device (or one containing LVM metadata) cannot be used unless the overwrite configuration option is set to 'true'.

config-flags

Comma-separated list of key=value configuration flags. These will be added to Cinder's cinder.conf file and will only affect the LVM backend.

overwrite

Permits (with a value of 'true') the charm to attempt to overwrite storage devices (specified by the block-devices option) if they contain pre-existing filesystems or LVM metadata. The default is 'false'. A device in use on the host will never be overwritten.

Deployment

Specify a block device (here we choose /dev/sdb) and then add a relation to the cinder charm:

juju deploy --config block-device=sdb cinder-lvm
juju add-relation cinder-lvm:storage-backend cinder:storage-backend

Documentation

The OpenStack Charms project maintains two documentation guides:

Bugs

Please report bugs on Launchpad.