[DOCS] Cleanup the role docs for consistency and clarity
Utilizing RST includes to reduce duplication of documentation effort. All contents of the Ansible defaults/main.yml are now included in the documentation directly. Change-Id: Ic3432433435a849913f243ea37302a484787256e
This commit is contained in:
parent
e9c5b96a5e
commit
70a7da15f5
44
README.rst
44
README.rst
|
@ -1,15 +1,46 @@
|
||||||
OpenStack cinder
|
OpenStack-Ansible Cinder
|
||||||
################
|
########################
|
||||||
:tags: openstack, cinder, cloud, ansible
|
|
||||||
:category: \*nix
|
|
||||||
|
|
||||||
Role for deployment, setup and installation of cinder.
|
This Ansible role installs and configures OpenStack Cinder.
|
||||||
|
|
||||||
This role will install the following:
|
The following Cinder services are managed by the role:
|
||||||
* cinder-api
|
* cinder-api
|
||||||
* cinder-volume
|
* cinder-volume
|
||||||
* cinder-scheduler
|
* 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
|
.. code-block:: yaml
|
||||||
|
|
||||||
- name: Installation and setup of cinder
|
- name: Installation and setup of cinder
|
||||||
|
@ -18,4 +49,5 @@ This role will install the following:
|
||||||
roles:
|
roles:
|
||||||
- { role: "os_cinder", tags: [ "os-cinder" ] }
|
- { role: "os_cinder", tags: [ "os-cinder" ] }
|
||||||
vars:
|
vars:
|
||||||
|
cinder_glance_api_servers: "http://glance_server:9292"
|
||||||
cinder_galera_address: "{{ internal_lb_vip_address }}"
|
cinder_galera_address: "{{ internal_lb_vip_address }}"
|
||||||
|
|
|
@ -13,9 +13,6 @@
|
||||||
# See the License for the specific language governing permissions and
|
# See the License for the specific language governing permissions and
|
||||||
# limitations under the License.
|
# limitations under the License.
|
||||||
|
|
||||||
# Defines that the role will be deployed on a host machine
|
|
||||||
is_metal: true
|
|
||||||
|
|
||||||
## APT Cache options
|
## APT Cache options
|
||||||
cache_timeout: 600
|
cache_timeout: 600
|
||||||
|
|
||||||
|
@ -158,7 +155,7 @@ cinder_iscsi_port: 3260
|
||||||
## Cinder RPC
|
## Cinder RPC
|
||||||
cinder_rpc_backend: rabbit
|
cinder_rpc_backend: rabbit
|
||||||
|
|
||||||
# (StrOpt) Method used to wipe old voumes (valid options are: none, zero,
|
# (StrOpt) Method used to wipe old volumes (valid options are: none, zero,
|
||||||
# shred)
|
# shred)
|
||||||
cinder_volume_clear: shred
|
cinder_volume_clear: shred
|
||||||
# (StrOpt) The flag to pass to ionice to alter the i/o priority of the process
|
# (StrOpt) The flag to pass to ionice to alter the i/o priority of the process
|
||||||
|
@ -187,8 +184,6 @@ cinder_quota_backups: 10
|
||||||
cinder_quota_backup_gigabytes: 1000
|
cinder_quota_backup_gigabytes: 1000
|
||||||
|
|
||||||
## General configuration
|
## General configuration
|
||||||
## Set this in rpc_user_config.yml UNLESS you want all hosts to use the same
|
|
||||||
## Cinder backends. See the rpc_user_config example for more on how this is done.
|
|
||||||
# cinder_backends:
|
# cinder_backends:
|
||||||
# lvm:
|
# lvm:
|
||||||
# volume_group: cinder-volumes
|
# volume_group: cinder-volumes
|
||||||
|
@ -212,10 +207,8 @@ cinder_quota_backup_gigabytes: 1000
|
||||||
# "volume:create": ""
|
# "volume:create": ""
|
||||||
# "volume:delete": ""
|
# "volume:delete": ""
|
||||||
|
|
||||||
# Potential locations of glance
|
# Comma separated list of Glance API servers
|
||||||
# the variable cinder_glance_api_servers is a list of servers that can service glance
|
# cinder_glance_api_servers:
|
||||||
# by default this variable is undefined
|
|
||||||
#cinder_glance_api_servers:
|
|
||||||
|
|
||||||
cinder_glance_host: 127.0.0.1
|
cinder_glance_host: 127.0.0.1
|
||||||
cinder_glance_service_port: 9292
|
cinder_glance_service_port: 9292
|
||||||
|
@ -242,7 +235,7 @@ cinder_apt_packages:
|
||||||
cinder_requires_pip_packages:
|
cinder_requires_pip_packages:
|
||||||
- virtualenv
|
- virtualenv
|
||||||
- virtualenv-tools
|
- virtualenv-tools
|
||||||
- python-keystoneclient # Keystoneclient needed to OSA keystone lib
|
- python-keystoneclient # Keystoneclient needed by the keystone Ansible module
|
||||||
- httplib2
|
- httplib2
|
||||||
|
|
||||||
# Common pip packages
|
# Common pip packages
|
||||||
|
|
|
@ -1,23 +1 @@
|
||||||
os_cinder Role Docs
|
.. include:: ../../README.rst
|
||||||
===================
|
|
||||||
|
|
||||||
The os_cinder role is used to to deploy, configure and install OpenStack Block
|
|
||||||
Storage.
|
|
||||||
|
|
||||||
This role will install the following:
|
|
||||||
* cinder-api
|
|
||||||
* cinder-volume
|
|
||||||
* cinder-scheduler
|
|
||||||
|
|
||||||
Basic Role Example
|
|
||||||
^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
|
|
||||||
- name: Installation and setup of cinder
|
|
||||||
hosts: cinder_all
|
|
||||||
user: root
|
|
||||||
roles:
|
|
||||||
- { role: "os_cinder", tags: [ "os-cinder" ] }
|
|
||||||
vars:
|
|
||||||
cinder_galera_address: "{{ internal_lb_vip_address }}"
|
|
Loading…
Reference in New Issue