The 'docs' tox target executes the doc8 lint test which may result in failures when testing documentation builds, but OpenStack-CI does not execute that tox target. In order to ensure that we catch all standard documentation syntax errors and prevent them from merging, this patch includes the docs target in the 'linters' chain of tests. Fixes for any failures which result from executing this test are also included in the patch. Change-Id: I139e07601079b14e4c3634f9b5d0815abe6269db
65 lines
1.5 KiB
ReStructuredText
65 lines
1.5 KiB
ReStructuredText
OpenStack-Ansible Cinder
|
|
########################
|
|
|
|
This Ansible role installs and configures OpenStack Cinder.
|
|
|
|
The following Cinder services are managed by the role:
|
|
* cinder-api
|
|
* cinder-volume
|
|
* cinder-scheduler
|
|
|
|
By default, Cinder API v1 and v2 are both enabled.
|
|
|
|
Support for various Cinder backends is supported by the role. See role
|
|
internals for further details.
|
|
|
|
Support for volume backups to Swift or Ceph is support by the role. See role
|
|
internals for further details.
|
|
|
|
Default Variables
|
|
=================
|
|
|
|
.. literalinclude:: ../../defaults/main.yml
|
|
:language: yaml
|
|
:start-after: under the License.
|
|
|
|
|
|
Required Variables
|
|
==================
|
|
|
|
This list is not exhaustive at present. See role internals for further
|
|
details.
|
|
|
|
.. code-block:: yaml
|
|
|
|
# Comma separated list of Glance API servers
|
|
cinder_glance_api_servers: "http://glance_server:9292"
|
|
|
|
# Hostname or IP address of the Galera database
|
|
cinder_galera_address: "1.2.3.4"
|
|
|
|
Example Playbook
|
|
================
|
|
|
|
.. code-block:: yaml
|
|
|
|
- name: Installation and setup of cinder
|
|
hosts: cinder_all
|
|
user: root
|
|
roles:
|
|
- { role: "os_cinder", tags: [ "os-cinder" ] }
|
|
vars:
|
|
cinder_glance_api_servers: "http://glance_server:9292"
|
|
cinder_galera_address: "{{ internal_lb_vip_address }}"
|
|
|
|
Tags
|
|
====
|
|
|
|
This role supports two tags: ``cinder-install`` and ``cinder-config``
|
|
|
|
The ``cinder-install`` tag can be used to install and upgrade.
|
|
|
|
The ``cinder-config`` tag can be used to maintain configuration of the
|
|
service.
|
|
|