14fa102fe9
This patchset does the following things: - Implements the unit tests. - Standardizes the charm, adding the needed files and moving pre-existing ones into the correct directories. - Implements the bundles for functional tests. - Documents the charm's functionality. - Updates the requirements for tests and other targets. Change-Id: I23e2882486a96c0c07cd8393745ffa2b244191a1 func-test-pr: https://github.com/openstack-charmers/zaza-openstack-tests/pull/626 |
||
|---|---|---|
| src | ||
| unit_tests | ||
| .gitignore | ||
| .gitreview | ||
| .stestr.conf | ||
| .zuul.yaml | ||
| README.md | ||
| copyright | ||
| metadata.yaml | ||
| osci.yaml | ||
| pip.sh | ||
| requirements.txt | ||
| test-requirements.txt | ||
| tox.ini | ||
README.md
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][juju-docs-config-apps] 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 config flags. These values will be added to standard options when injecting config into cinder.conf.
overwrite
Permits ('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
To deploy, add a relation to the cinder charm:
juju add-relation cinder-lvm:storage-backend cinder:storage-backend
Documentation
The OpenStack Charms project maintains two documentation guides:
- OpenStack Charm Guide: for project information, including development and support notes
- OpenStack Charms Deployment Guide: for charm usage information
Bugs
Please report bugs on Launchpad.