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

toc::[]

[role="_abstract"]
{product-title} supports GCE Persistent Disk volumes (gcePD). You can provision your {product-title} cluster with persistent storage
using GCE. Some familiarity with Kubernetes and GCE is assumed.

The Kubernetes persistent volume framework allows administrators to provision a cluster with persistent storage and gives users a way to request those resources without having any knowledge of the underlying infrastructure.

GCE Persistent Disk volumes can be provisioned dynamically.

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.

ifndef::openshift-dedicated[]
[IMPORTANT]
====
{product-title} 4.12 and later provides automatic migration for the GCE Persist Disk 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.
====
endif::openshift-dedicated[]

[IMPORTANT]
====
High availability of storage in the infrastructure is left to the underlying storage provider.
====

[role="_additional-resources"]
.Additional resources

* link:https://cloud.google.com/compute/docs/disks/[GCE Persistent Disk]
ifndef::openshift-dedicated[]
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration[CSI automatic migration]
endif::openshift-dedicated[]

// Defining attributes required by the next module
:StorageClass: GCE
:Provisioner: kubernetes.io/gce-pd

include::modules/storage-create-storage-class.adoc[leveloffset=+1]

include::modules/storage-persistent-storage-creating-volume-claim.adoc[leveloffset=+1]

:provider: GCE
include::modules/storage-persistent-storage-volume-format.adoc[leveloffset=+1]
