:_mod-docs-content-type: ASSEMBLY
[id="persistent-storage-cinder"]
= Persistent storage using Cinder
include::_attributes/common-attributes.adoc[]
:context: persistent-storage-cinder

toc::[]

[role="_abstract"]
{product-title} supports OpenStack Cinder volumes. You can provision your {product-title} cluster with persistent storage using OpenStack Cinder. Some familiarity with Kubernetes and OpenStack is assumed.

Persistent volumes are not bound to a single project or namespace; they can be shared across the {product-title} cluster. Persistent volume claims are specific to a project or namespace and can be requested by users.

[IMPORTANT]
====
{product-title} 4.11 and later provides automatic migration for the Cinder in-tree volume plugin to its equivalent CSI driver.

CSI automatic migration should be seamless. Migration does not change how you use all existing API objects, such as persistent volumes, persistent volume claims, and storage classes. For more information about migration, see "CSI automatic migration".
====

[role="_additional-resources"]
.Additional resources
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration[CSI automatic migration]
* link:https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/8/html-single/architecture_guide/index#comp-cinder[OpenStack Cinder]

include::modules/persistent-storage-cinder-provisioning.adoc[leveloffset=+1]

include::modules/persistent-storage-cinder-creating-pv.adoc[leveloffset=+2]

include::modules/persistent-storage-cinder-pv-format.adoc[leveloffset=+2]

include::modules/persistent-storage-cinder-volume-security.adoc[leveloffset=+2]
