CNV-23190: custom namespace for golden images

Author: ousleyp

modules/virt-golden-images-namespace-cli.adoc

@@ -0,0 +1,42 @@
+// Module included in the following assemblies:
+//
+// * virt/creating_vms_advanced/creating_vms_advanced_web/virt-creating-vms-from-rh-images-overview.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-golden-images-namespace-cli_{context}"]
+= Configuring a custom namespace for golden images by using the CLI
+
+You can configure a custom namespace for golden images in your cluster by setting the `spec.commonBootImageNamespace` field in the `HyperConverged` custom resource (CR).
+
+.Prerequisites
+
+* You installed the {oc-first}.
+
+* You created a namespace to use for golden images.
+
+.Procedure
+
+. Open the `HyperConverged` CR in your default editor by running the following command:
++
+[source,terminal,subs="attributes+"]
+----
+$ oc edit hyperconverged kubevirt-hyperconverged -n {CNVNamespace}
+----
+
+. Configure the custom namespace by updating the value of the `spec.commonBootImageNamespace` field:
++
+.Example configuration file
+[source,yaml,subs="attributes+"]
+----
+apiVersion: hco.kubevirt.io/v1
+kind: HyperConverged
+metadata:
+  name: kubevirt-hyperconverged
+  namespace: {CNVNamespace}
+spec:
+  commonBootImageNamespace: <custom_namespace> <1>
+# ...
+----
+<1> The namespace to use for golden images.
+
+. Save your changes and exit the editor.

modules/virt-golden-images-namespace-web.adoc

@@ -0,0 +1,26 @@
+// Module included in the following assemblies:
+//
+// * virt/creating_vms_advanced/creating_vms_advanced_web/virt-creating-vms-from-rh-images-overview.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-golden-images-namespace-web_{context}"]
+= Configuring a custom namespace for golden images by using the web console
+
+You can configure a custom namespace for golden images in your cluster by using the {product-title} web console.
+
+.Procedure
+
+. In the web console, select *Virtualization* -> *Overview*.
+
+. Select the *Settings* tab.
+
+. On the *Cluster* tab, select *General settings* -> *Bootable volumes project*.
+
+. Select a namespace to use for golden images.
+.. If you already created a namespace, select it from the *Project* list.
+
+.. If you did not create a namespace, scroll to the bottom of the list and click *Create project*.
+
+... Enter a name for your new namespace in the *Name* field of the *Create project* dialog.
+
+... Click *Create*.

virt/creating_vms_advanced/creating_vms_advanced_web/virt-creating-vms-from-rh-images-overview.adoc

@@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-Red Hat images are xref:../../../virt/creating_vms_advanced/creating_vms_advanced_web/virt-creating-vms-from-rh-images-overview.adoc#virt-about-golden-images_virt-creating-vms-from-rh-images-overview[golden images]. They are published as container disks in a secure registry. The Containerized Data Importer (CDI) polls and imports the container disks into your cluster and stores them in the `openshift-virtualization-os-images` project as snapshots or persistent volume claims (PVCs).
+Red Hat images are xref:../../../virt/creating_vms_advanced/creating_vms_advanced_web/virt-creating-vms-from-rh-images-overview.adoc#virt-about-golden-images_virt-creating-vms-from-rh-images-overview[golden images]. They are published as container disks in a secure registry. The Containerized Data Importer (CDI) polls and imports the container disks into your cluster and stores them in the `openshift-virtualization-os-images` project as snapshots or persistent volume claims (PVCs). You can optionally xref:../../../virt/creating_vms_advanced/creating_vms_advanced_web/virt-creating-vms-from-rh-images-overview.adoc#configuring-custom-namespace-golden-images[use a custom namespace] for golden images.
 
 Red Hat images are automatically updated. You can disable and re-enable automatic updates for these images. See xref:../../../virt/storage/virt-automatic-bootsource-updates.adoc#managing-rh-boot-source-updates_virt-automatic-bootsource-updates[Managing Red Hat boot source updates].
 
@@ -28,3 +28,12 @@ Do not create VMs in the default `openshift-*` namespaces. Instead, create a new
 include::modules/virt-golden-images.adoc[leveloffset=+1]
 
 include::modules/virt-about-vms-and-boot-sources.adoc[leveloffset=+1]
+
+[id="configuring-custom-namespace-golden-images"]
+== Configuring a custom namespace for golden images
+
+The default namespace for golden images is `openshift-virtualization-os-images`, but you can configure a custom namespace to restrict user access to the default boot sources.
+
+include::modules/virt-golden-images-namespace-web.adoc[leveloffset=+2]
+
+include::modules/virt-golden-images-namespace-cli.adoc[leveloffset=+2]