Merge pull request #28763 from bgaydosrh/CNV-9040_2

CNV-9886 DOC - Boot source 2.6 UI updates

Author: jeana-redhat

_topic_map.yml

@@ -2652,8 +2652,8 @@ Topics:
       File: virt-cloning-a-datavolume-using-smart-cloning
     - Name: Storage defaults for data volumes
       File: virt-storage-defaults-for-datavolumes
-    - Name: Creating and using default OS images
-      File: virt-creating-and-using-default-os-images
+    - Name: Creating and using boot sources
+      File: virt-creating-and-using-boot-sources
     - Name: Using container disks with virtual machines
       File: virt-using-container-disks-with-vms
     - Name: Preparing CDI scratch space

modules/virt-creating-a-vm-from-a-default-os-image.adoc

@@ -0,0 +1,18 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/virtual_disks/virt-creating-and-using-boot-sources.adoc
+
+[id="virt-creating-a-vm-from-a-template-with-an-attached-boot-source_{context}"]
+= Creating a virtual machine from a template with an attached boot source
+
+After you add a boot source to a template, you can create a new virtual machine from the template.
+
+.Procedure
+
+. In the {product-title} web console, click *Workloads > Virtualization* in the side menu.
+. From the *Virtual Machines* tab or the *Templates* tab, click *Create* and select *Virtual Machine with Wizard*.
+. In the *General* step, select an OS from the Operating System list that has the *(Source available)* label next to the OS and version name. The *(Source available)* label indicates that a boot source is available for this OS.
+. Ensure that the *Clone available operating system source* checkbox is selected.
+. Click *Review and Confirm*.
+. Review your virtual machine settings and edit them, if required.
+. Click *Create Virtual Machine* to create your virtual machine. The *Successfully created virtual machine* page is displayed. 

modules/virt-creating-a-vm-from-a-template-with-an-attached-boot-source.adoc

@@ -0,0 +1,52 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/virtual_disks/virt-creating-and-using-boot-sources.adoc
+
+[id="virt-using-supported-boot-source-names_{context}"]
+= Supported boot source names
+
+When you add boot sources, you associate them with templates for specific operating systems.
+
+It is important that the boot source volume name matches the predefined name of the template. If the volume name does not match the name defined by the template, you will be unable to add the boot source and use it to create virtual machines.
+
+If you add a boot source by using the web console, you do not need to supply the boot source name because it is already associated with the appropriate template. When using the CLI, you must specify the supported boot source name in your YAML code when creating a volume.
+
+Use the following table to determine the supported name of a boot source for various operating systems.
+
+[cols="2",options="header"]
+.Supported boot source names for operating systems
+|===
+|To create a boot source for this OS:
+|Name the volume:
+
+|Fedora
+|fedora
+
+|Centos 7
+|centos7
+
+|Centos 8
+|centos8
+
+|Red Hat Enterprise Linux 6
+|rhel6
+
+|Red Hat Enterprise Linux 7
+|rhel7
+
+|Red Hat Enterprise Linux 8
+|rhel8
+
+|Windows 10
+|win10
+
+|Windows 2012 Server Release 2
+|win2k12r2
+
+|Windows 2016 Server
+|win2k16
+
+|Windows 2019 Server
+|win2k19
+
+|===

modules/virt-creating-pvcs-to-store-default-os-images.adoc

@@ -0,0 +1,27 @@
+[id="virt-creating-and-using-boot-sources"]
+= Creating and using boot sources
+include::modules/virt-document-attributes.adoc[]
+:context: virt-creating-and-using-boot-sources
+toc::[]
+
+A _boot source_ contains a bootable operating system (OS) and all of the configuration settings for the OS, such as drivers.
+
+You use a boot source to create virtual machine templates with specific configurations. These templates can be used to create any number of available virtual machines.
+
+.Prerequisites
+* To add a boot source, you must be logged in as a user with the `os-images.kubevirt.io:edit` RBAC role or as an administrator. You do not need special privileges to create a virtual machine from a template with a boot source attached.
+
+[NOTE]
+====
+For information about requirements for Microsoft Windows, refer to link:https://www.openshift.com/blog/creating-an-operating-system-image-using-the-microsoft-windows-installation-media-with-openshift-virtualization[Creating installation media for Windows boot sources].
+====
+
+// Commenting this module with list of supported DV names for 2.6. It is relevant only to 2.6.1 when the CLI flow is introduced
+// include::modules/virt-using-supported-boot-source-names.adoc[leveloffset=+1]
+
+include::modules/virt-adding-a-boot-source-web.adoc[leveloffset=+1]
+
+include::modules/virt-creating-a-vm-from-a-template-with-an-attached-boot-source.adoc[leveloffset=+1]
+
+== Additional resources
+* xref:../../../virt/virtual_machines/virtual_disks/virt-uploading-local-disk-images-web.adoc#virt-uploading-local-disk-images-web[Uploading local disk images]