Merge pull request #41072 from mgarrellRH/CNV8909

CNV8909 Adding VM disk enlargement feature

Author: sjhala-ccs

_topic_maps/_topic_map.yml

@@ -3072,6 +3072,8 @@ Topics:
       File: virt-preparing-cdi-scratch-space
     - Name: Re-using statically provisioned persistent volumes
       File: virt-reusing-statically-provisioned-persistent-volumes
+    - Name: Expanding a virtual machine disk
+      File: virt-expanding-vm-disk
     - Name: Deleting data volumes
       File: virt-deleting-datavolumes
 # Templates

modules/virt-enlarging-vm-disk.adoc

@@ -0,0 +1,40 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/virtual_disks/virt-vm-disk-resizing.adoc
+
+:_content-type: PROCEDURE
+[id="virt-enlarging-vm-disk_{context}"]
+= Enlarging a virtual machine disk
+
+VM disk enlargement makes extra space available to the virtual machine. However, it is the responsibility of the VM owner to decide how to consume the storage.
+
+If the disk is a `Filesystem` PVC, the matching file expands to the remaining size while reserving some space for file system overhead.
+
+.Procedure
+
+. Edit the `PersistentVolumeClaim` manifest of the VM disk that you want to expand:
++
+[source,terminal]
+
+----
+$ oc edit pvc <pvc_name>
+----
+
+. Change the value of `spec.resource.requests.storage` attribute to a larger size.
++
+[source,yaml]
+
+----
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+   name: vm-disk-expand
+spec:
+  accessModes:
+     - ReadWriteMany
+  resources:
+    requests:
+       storage: 3Gi <1>
+...
+----
+<1> The VM disk size that can be increased

virt/virtual_machines/virtual_disks/virt-expanding-vm-disk.adoc

@@ -0,0 +1,21 @@
+:_content-type: ASSEMBLY
+[id="virt-vm-disk-resizing"]
+= Expanding a virtual machine disk
+include::modules/virt-document-attributes.adoc[]
+include::modules/common-attributes.adoc[]
+:context: virt-expanding-vm-disk
+
+toc::[]
+
+You can enlarge the size of a virtual machine's (VM) disk to provide a greater storage capacity by resizing the disk's persistent volume claim (PVC).
+
+However, you cannot reduce the size of a VM disk.
+
+include::modules/virt-enlarging-vm-disk.adoc[leveloffset=+1]
+
+[id="additional-resources_virt-vm-disk-resizing"]
+== Additional resources
+
+* link:https://docs.microsoft.com/en-us/windows-server/storage/disk-management/extend-a-basic-volume[Extending a basic volume in Windows].
+* link:https://access.redhat.com/solutions/29095[Extending an existing file system partition without destroying data in Red Hat Enterprise Linux].
+* link:https://access.redhat.com/solutions/24770[Extending a logical volume and its file system online in Red Hat Enterprise Linux].