dubzland.openstack.openstack_cinder role – Install and configure the OpenStack Cinder block storage component.

Note

This role is part of the dubzland.openstack collection (version 1.1.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install dubzland.openstack.

To use it in a playbook, specify: dubzland.openstack.openstack_cinder.

Entry point main – Install and configure the OpenStack Cinder block storage component.

Synopsis

  • Creates databases and configures users

  • Creates OpenStack services and associated users

  • Creates OpenStack endpoints within OpenStack Keystone

  • Installs required operating system packages

  • Applies desired configuration using templates

  • Retrieves required ceph configuration

Parameters

Parameter

Comments

openstack_cinder_ceph_integration

boolean

Controls installation and configuration of the Ceph RBD client for Cinder.

Choices:

  • false ← (default)

  • true

openstack_cinder_controller_packages

list / elements=string

List of packages installed on the controller node for the Cinder component.

Default: ["cinder-api", "cinder-scheduler"]

openstack_cinder_controller_services

list / elements=string

Services to be restarted during install (and/or configuration changes) on the controller node.

Default: ["cinder-scheduler", "apache2"]

openstack_cinder_db_name

string

Name of the MySQL database created.

Default: "cinder"

openstack_cinder_db_password

string / required

Database password created for the openstack_cinder_db_user.

openstack_cinder_db_user

string

Database user created for the OpenStack Cinder component.

Default: "cinder"

openstack_cinder_default_volume_type

string

Default type for Cinder volumes.

Default: "lvm"

openstack_cinder_nfs_client

boolean

Controls installation and configuration of the NFS client.

Choices:

  • false ← (default)

  • true

openstack_cinder_nfs_shares

list / elements=dictionary

List of NFS shares to make available to OpenStack Cinder.

hostname

string / required

Hostname or IP address of the NFS server.

path

path / required

Path on the NFS server used for NFS storage.

openstack_cinder_service_description

string

Human-readable description for the OpenStack Cinder service within Keystone.

Default: "OpenStack Block Storage"

openstack_cinder_service_password

string / required

Service password assigned to the openstack_cinder_service_user.

openstack_cinder_service_user

string

User created in OpenStack Keystone for the Cinder component.

Default: "cinder"

openstack_cinder_storage_nfs_packages

list / elements=string

List of packages to install on storage nodes when NFS storage is enabled.

Default: ["nfs-common"]

openstack_cinder_storage_packages

list / elements=string

List of packages installed on the storage nodes for the Cinder component.

Default: ["cinder-volume", "tgt", "ceph-common"]

openstack_cinder_storage_services

list / elements=string

Services to be restarted during install (and/or configuration changes) on the storage nodes.

Default: ["tgt", "cinder-volume"]

openstack_cinder_truenas_integration

boolean

Controls installation and configuration of the TrueNAS client.

Choices:

  • false ← (default)

  • true

openstack_cinder_volume_types

list / elements=dictionary

Volume types to be configured within the Cinder subsystem.

description

string

Human-readable description stored in the database for this volume type.

name

string / required

Name to assign to the volume type, both in the database and configuration file.

specs

dictionary

Specifications stored in the configuration file for this volume type.

Default: {}

state

string

Desired state of this volume type, both in the database and the configuration file.

Choices:

  • "present"

  • "absent"