Merge pull request #71208 from aspauldi/CNV-35207_1

CNV-35207_1: [Docs] Cloning from cached snapshots in UI

Author: bscott-rh

modules/virt-about-vm-snapshots.adoc

@@ -18,6 +18,7 @@ The snapshot stores a copy of each Container Storage Interface (CSI) volume atta
 You can perform the following snapshot actions:
 
 * Create a new snapshot
+* Create a copy of a virtual machine from a snapshot
 * List all snapshots attached to a specific VM
 * Restore a VM from a snapshot
 * Delete an existing VM snapshot

modules/virt-cloning-vm-snapshot.adoc

@@ -0,0 +1,19 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/creating_vms_rh/creating-vms-from-instance-types.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-cloning-vm-snapshot_{context}"]
+= Cloning a VM by using the web console
+
+You can clone an existing VM by using the web console.
+
+.Procedure
+
+. Navigate to *Virtualization* -> *VirtualMachines* in the web console.
+. Select a VM to open the *VirtualMachine details* page.
+. Click *Actions*.
+. Select *Clone*.
+. On the *Clone VirtualMachine* page, enter the name of the new VM.
+. (Optional) Select the *Start cloned VM* checkbox to start the cloned VM.
+. Click *Clone*.

modules/virt-creating-vm-from-snapshot-web.adoc

@@ -0,0 +1,20 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/creating_vms_rh/creating-vms-from-instance-types.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-creating-vm-from-snapshot-web_{context}"]
+= Creating a VM from an existing snapshot by using the web console
+
+You can create a new VM by copying an existing snapshot.
+
+.Procedure
+
+. Navigate to *Virtualization* -> *VirtualMachines* in the web console.
+. Select a VM to open the *VirtualMachine details* page.
+. Click the *Snapshots* tab.
+. Click the actions menu {kebab} for the snapshot you want to copy.
+. Select *Create VirtualMachine*.
+. Enter the name of the virtual machine.
+. (Optional) Select the *Start this VirtualMachine after creation* checkbox to start the new virtual machine.
+. Click *Create*.

modules/virt-creating-vm-instancetype.adoc

@@ -21,7 +21,7 @@ endif::[]
 = {title} from an instance type
 
 ifdef::virt-create-vms[]
-You can create a virtual machine (VM) from an instance type by using the {product-title} web console.
+You can create a virtual machine (VM) from an instance type by using the {product-title} web console. You can also use the web console to create a VM by copying an existing snapshot or to clone a VM.
 endif::[]
 ifdef::static-key[]
 You can add a statically managed SSH key when you create a virtual machine (VM) from an instance type by using the {product-title} web console. The key is added to the VM as a cloud-init data source at first boot. This method does not affect cloud-init user data.
@@ -40,13 +40,18 @@ endif::[]
 .Procedure
 
 . In the web console, navigate to *Virtualization* -> *Catalog* and click the *InstanceTypes* tab.
-. Select a bootable volume.
+. Select either of the following options:
+* Select a bootable volume.
 +
 [NOTE]
 ====
-The volume table only lists volumes in the `openshift-virtualization-os-images` namespace that have the `instancetype.kubevirt.io/default-preference` label.
+The bootable volume table lists only those volumes in the `openshift-virtualization-os-images` namespace that have the `instancetype.kubevirt.io/default-preference` label.
 ====
-.. Optional: Click the star icon to designate a bootable volume as a favorite. Starred bootable volumes appear first in the volume list.
++
+** Optional: Click the star icon to designate a bootable volume as a favorite. Starred bootable volumes appear first in the volume list.
+
+* Click *Add volume* to upload a new volume or use an existing persistent volume claim (PVC), volume snapshot, or data source. Then click *Save*.
+
 
 ifdef::virt-create-vms[]
 . Click an instance type tile and select the resource size appropriate for your workload.

virt/getting_started/virt-web-console-overview.adoc

@@ -388,7 +388,6 @@ By default, Red Hat templates are stored in the `openshift` project. You can edi
 You create a virtual machine from an instance type on the *InstanceTypes* tab.
 
 :FeatureName: Creating a virtual machine from an instance type
-include::snippets/technology-preview.adoc[]
 
 [%collapsible]
 =====
@@ -973,7 +972,7 @@ You must manually disconnect the console connection if you open a new console se
 [id="virtualmachine-details-snapshots_virt-web-console-overview"]
 ==== Snapshots tab
 
-You create snapshots and restore virtual machines from snapshots on the *Snapshots* tab.
+You can create a snapshot, create a copy of a virtual machine from a snapshot, restore a snapshot, edit labels or annotations, and edit or delete volume snapshots on the *Snapshots* tab.
 
 .*Snapshots* tab
 [%collapsible]
@@ -997,7 +996,7 @@ You create snapshots and restore virtual machines from snapshots on the *Snapsho
 
 Click the snapshot name to edit the labels or annotations.
 
-Click the actions menu {kebab} beside a snapshot to select *Restore* or *Delete*.
+Click the actions menu {kebab} beside a snapshot to select *Create VirtualMachine*, *Restore*, or *Delete*.
 |====
 =====
 

virt/virtual_machines/creating_vms_rh/virt-creating-vms-from-instance-types.adoc

@@ -8,4 +8,8 @@ toc::[]
 
 You can create virtual machines (VMs) from instance types by using the {product-title} web console.
 
-include::modules/virt-creating-vm-instancetype.adoc[leveloffset=+1]
+include::modules/virt-creating-vm-instancetype.adoc[leveloffset=+1]
+
+include::modules/virt-creating-vm-from-snapshot-web.adoc[leveloffset=+1]
+
+include::modules/virt-cloning-vm-snapshot.adoc[leveloffset=+1]