Merge pull request #112212 from Vaishali-gif-rh/CNV-62146

CNV-62146: Boot source garbage collection configuration

Author: sjhala-ccs

modules/virt-increasing-bootsource-disk-image-retention.adoc

@@ -0,0 +1,45 @@
+// Module included in the following assemblies:
+//
+// * virt-increasing-bootsource-disk-image-retention.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-increasing-bootsource-disk-image-retention_{context}"]
+= Increasing boot source disk image retention
+
+[role="_abstract"]
+You can configure image retention settings to increase the number of older operating system image versions preserved on the cluster.
+
+When automatic boot source updates are enabled, the Containerized Data Importer (CDI) tracks and downloads the latest versions of operating system images. By default, the system aggressively minimizes the retention of older versions to conserve disk space. However, if you require a safety mechanism that allows you to roll back if a newly imported version introduces issues, you can increase the retention count.
+
+[NOTE]
+====
+Manually deleting older `PersistentVolumeClaim` or `DataVolume` objects associated with historic boot source imports does not impact cluster stability or future updates.
+====
+
+.Procedure
+
+. Open the `HyperConverged` custom resource (CR) in your default editor:
++
+[source,terminal]
+----
+$ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
+----
+
+. Edit the `spec.dataImportCronTemplates` field to adjust the `importsToKeep` parameter to your preferred retention threshold:
++
+[source,yaml]
+----
+apiVersion: hco.kubevirt.io/v1beta1
+kind: HyperConverged
+metadata:
+  name: kubevirt-hyperconverged
+spec:
+  dataImportCronTemplates:
+    - metadata:
+        name: rhel9-image-cron
+      spec:
+        garbageCollect: Outdated <1>
+        importsToKeep: 3
+        schedule: "0 */12 * * *"
+        managedDataSource: rhel9
+----

virt/storage/virt-automatic-bootsource-updates.adoc

@@ -21,6 +21,8 @@ include::modules/virt-enabling-volume-snapshot-boot-source.adoc[leveloffset=+1]
 
 include::modules/virt-disable-auto-updates-single-boot-source.adoc[leveloffset=+1]
 
+include::modules/virt-increasing-bootsource-disk-image-retention.adoc[leveloffset=+1]
+
 include::modules/virt-verify-status-bootsource-update.adoc[leveloffset=+1]
 
 [role="_additional-resources"]