From 1d992b5e3a2a050637a4c536f768e0c82e0dd71e Mon Sep 17 00:00:00 2001 From: Srini Brahmaroutu Date: Thu, 23 Aug 2018 11:00:19 -0700 Subject: [PATCH] Documenting FlexVolume Resize alpha feature. --- .../en/docs/concepts/storage/persistent-volumes.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/content/en/docs/concepts/storage/persistent-volumes.md b/content/en/docs/concepts/storage/persistent-volumes.md index 34319ba549a4c..89e3e4b86f533 100644 --- a/content/en/docs/concepts/storage/persistent-volumes.md +++ b/content/en/docs/concepts/storage/persistent-volumes.md @@ -192,6 +192,7 @@ the following types of volumes: * Azure File * Azure Disk * Portworx +* FlexVolumes You can only expand a PVC if its storage class's `allowVolumeExpansion` field is set to true. @@ -227,16 +228,25 @@ kubectl describe pvc If the `PersistentVolumeClaim` has the status `FileSystemResizePending`, it is safe to recreate the pod using the PersistentVolumeClaim. -#### Resizing an in-use PersistentVolumeClaim +FlexVolumes allow resize if the driver is set with the `RequiresFSResize` capability to true. +The FlexVolume can be resized on pod restart. {{< feature-state for_k8s_version="v1.11" state="alpha" >}} +#### Resizing an in-use PersistentVolumeClaim + Expanding in-use PVCs is an alpha feature. To use it, enable the `ExpandInUsePersistentVolumes` feature gate. In this case, you don't need to delete and recreate a Pod or deployment that is using an existing PVC. Any in-use PVC automatically becomes available to its Pod as soon as its file system has been expanded. This feature has no effect on PVCs that are not in use by a Pod or deployment. You must create a Pod which uses the PVC before the expansion can complete. +Expanding in-use PVCs for FlexVolumes is added in release 1.13. To enable this feature use `ExpandInUsePersistentVolumes` and `ExpandPersistentVolumes` feature gates. The `ExpandPersistentVolumes` feature gate is already enabled by default. If the `ExpandInUsePersistentVolumes` is set, FlexVolume can be resized online without pod restart. + +{{< note >}} +**Note:** FlexVolume resize is possible only when the underlying driver supports resize. +{{< /note >}} + {{< note >}} **Note:** Expanding EBS volumes is a time consuming operation. Also, there is a per-volume quota of one modification every 6 hours. {{< /note >}}