Merge pull request #58385 from sabrinajess/CNV21228

CNV-21228: new content

Author: apinnick

modules/virt-creating-vm-instancetype.adoc

@@ -0,0 +1,36 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/virt-create-vms.adoc
+
+:_content-type: PROCEDURE
+[id="virt-creating-vm-instancetype_{context}"]
+= Creating a virtual machine from an instance type
+
+[IMPORTANT]
+====
+This is a Developer Preview feature only. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to upcoming product features in advance of their possible inclusion in a Red Hat product offering, enabling customers to test functionality and provide feedback during the development process. These features might not have any documentation, are subject to change or removal at any time, and testing is limited. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
+====
+
+You can use common instance types to install and edit customized instance types and preferences to create a virtual machine (VM).
+
+.Procedure
+
+. In the web console, navigate to the *InstanceTypes* tab in one of the following ways: 
+
++
+* Click *Virtualization* -> *Catalog* -> *InstanceTypes*.
+* Click *Virtualization* -> *VirtualMachines* and select *From volume* in the *Create* dropdown menu. 
+
+. Select a volume to boot from.
+
+. Select an 'InstanceType'. 
+
+. Select the 'InstanceType' size based on the VM's available CPUs and memory.
+
+. Optional: Edit the 'VirtualMachine' details. You can edit the SSH key during this step under *Advanced settings*.
+
+. Optional: Uncheck *Start this VirtualMachine after creation* to prevent the VM from starting automatically. By default, this box is checked and the VM will start after creation.
+
+. Click *Create VirtualMachine*.
+
+After the VM is created, you can monitor the status on the *VirtualMachine details* page.

virt/virt-web-console-overview.adoc

@@ -298,9 +298,9 @@ The *User permissions* tab displays cluster-wide user permissions for tasks.
 [id="ui-catalog-page_{context}"]
 == Catalog page
 
-You can create a VirtualMachine by selecting a template on the Catalog page.
+You can create a VirtualMachine by selecting a template or boot source on the Catalog page.
 
-.Catalog page
+.*Template catalog* tab
 [%collapsible]
 =====
 [cols="1,3a", options="header"]
@@ -333,6 +333,49 @@ By default, Red Hat templates are stored in the `openshift` project. You can edi
 |====
 =====
 
+.*InstanceTypes* tab
+[%collapsible]
+
+:FeatureName: Creating a virtual machine from an instance type
+include::snippets/developer-preview.adoc[]
+
+=====
+[cols="1,3a", options="header"]
+|====
+|Element
+|Description
+
+|*Volumes project* list
+|Select the volume to boot your VM from.
+
+|*Add volume*
+|Upload a new volume or use an existing PersistentVolumeClaim (PVC).
+
+|*Filter* field
+|Filter boot sources by operating system.
+
+|Search field
+|Search boot sources by keyword.
+
+|*Select InstanceType* 
+|Select an instance type based on the number of CPUs and amount of memory available.
+
+|*VirtualMachine details*
+|Displays the current VM settings. You can change the name of the VM during this step.
+
+|*Advanced settings*
+|Add an authorized SSH key to the VM.
+
+|*Start this VirtualMachine after creation* checkbox
+|Checked by default. Uncheck this to prevent the new VM from starting after creation.
+
+|*Create VirtualMachine*
+|Creates a VM using the boot source and settings chosen on the *InstanceTypes* tab.
+|====
+=====
+
+
+
 [id="ui-virtualmachines-page_{context}"]
 == VirtualMachines page
 

virt/virtual_machines/virt-create-vms.adoc

@@ -36,6 +36,8 @@ include::modules/virt-creating-vm-custom-template.adoc[leveloffset=+1]
 
 Refer to the virtual machine fields section when creating a VM from the web console.
 
+include::modules/virt-creating-vm-instancetype.adoc[leveloffset=+1]
+
 :virtualmachine:
 include::modules/virt-networking-wizard-fields-web.adoc[leveloffset=+3]