Reorganizing "creating VMs"

apinnick · apinnick · commit 549ef30ee15e · 2023-08-28T14:18:48.000+03:00
Signed-off-by: Avital Pinnick &lt;apinnick@redhat.com&gt;
diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml
@@ -3673,7 +3673,7 @@ Topics:
   Topics:
 ###VIRTUAL MACHINE CHESS SALAD (silly name to highlight that the commented out assemblies need to be checked against merged filenams)
   - Name: Creating virtual machines
-    File: virt-create-vms
+    File: virt-creating-vms
   - Name: Connecting to VM consoles
     File: virt-accessing-vm-consoles
   - Name: Configuring SSH access to VMs
diff --git a/modules/virt-cloud-init-fields-web.adoc b/modules/virt-cloud-init-fields-web.adoc
@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 
 
 [id="virt-cloud-init-fields-web_{context}"]
diff --git a/modules/virt-creating-template.adoc b/modules/virt-creating-template.adoc
@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 
 :_content-type: PROCEDURE
 [id="virt-creating-template_{context}"]
diff --git a/modules/virt-creating-vm-cli.adoc b/modules/virt-creating-vm-cli.adoc
@@ -1,12 +1,12 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 
 :_content-type: PROCEDURE
 [id="virt-creating-vm-cli_{context}"]
-= Creating a virtual machine by using the command line
+= Creating a VM from a VirtualMachine manifest
 
-You can create a virtual machine (VM) by using the command line.
+You can create a virtual machine (VM) from a `VirtualMachine` manifest.
 
 .Procedure
 
diff --git a/modules/virt-creating-vm-from-template.adoc b/modules/virt-creating-vm-from-template.adoc
@@ -1,14 +1,14 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 
 :_content-type: PROCEDURE
 [id="virt-creating-vm-from-template_{context}"]
-= Creating a virtual machine from a template
+= Creating a VM from a template
 
 You can create a virtual machine (VM) from a template with an available boot source by using the {product-title} web console.
 
-You can customize the template or VM parameters, such as data sources, cloud-init, or SSH keys, before you start the VM.
+Optional: You can customize template or VM parameters, such as data sources, cloud-init, or SSH keys, before you start the VM.
 
 .Procedure
 
diff --git a/modules/virt-creating-vm-instancetype.adoc b/modules/virt-creating-vm-instancetype.adoc
@@ -1,10 +1,10 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 
 :_content-type: PROCEDURE
 [id="virt-creating-vm-instancetype_{context}"]
-= Creating a virtual machine from an instance type
+= Creating a VM from an instance type
 
 You create a virtual machine (VM) from an instance type by using the {product-title} web console.
 
diff --git a/modules/virt-creating-vm-yaml-web.adoc b/modules/virt-creating-vm-yaml-web.adoc
@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 
 :_content-type: PROCEDURE
 [id="virt-creating-vm-yaml-web_{context}"]
diff --git a/modules/virt-networking-wizard-fields-web.adoc b/modules/virt-networking-wizard-fields-web.adoc
@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 // * virt/vm_networking/virt-connecting-vm-to-linux-bridge.adoc
 
 
diff --git a/modules/virt-storage-wizard-fields-web.adoc b/modules/virt-storage-wizard-fields-web.adoc
@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 
 
 [id="virt-storage-wizard-fields-web_{context}"]
diff --git a/modules/virt-vm-storage-volume-types.adoc b/modules/virt-vm-storage-volume-types.adoc
@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * virt/virtual_machines/virt-create-vms.adoc
+// * virt/virtual_machines/virt-creating-vms.adoc
 
 [id="virt-vm-storage-volume-types_{context}"]
 = Storage volume types
diff --git a/virt/getting_started/virt-getting-started.adoc b/virt/getting_started/virt-getting-started.adoc
@@ -40,9 +40,9 @@ Plan and install {VirtProductName} on an {product-title} cluster:
 
 Create virtual machines (VMs):
 
-* xref:../../virt/virtual_machines/virt-create-vms.adoc#virt-creating-vm-from-template_virt-create-vms[Create a VM from a template].
-* xref:../../virt/virtual_machines/virt-create-vms.adoc#virt-creating-vm-instancetype_virt-create-vms[Create a VM from an instance type].
-* xref:../../virt/virtual_machines/virt-create-vms.adoc#virt-creating-vm-cli_virt-create-vms[Create a VM from the command line].
+* xref:../../virt/virtual_machines/virt-creating-vms.adoc#virt-creating-vm-from-template_virt-creating-vms[Create a VM from a template].
+* xref:../../virt/virtual_machines/virt-creating-vms.adoc#virt-creating-vm-instancetype_virt-creating-vms[Create a VM from an instance type].
+* xref:../../virt/virtual_machines/virt-creating-vms.adoc#virt-creating-vm-cli_virt-creating-vms[Create a VM from the command line].
 
 :FeatureName: Creating a virtual machine from an instance type
 include::snippets/technology-preview.adoc[]
diff --git a/virt/virtual_machines/advanced_vm_management/virt-configuring-vgpu-passthrough.adoc b/virt/virtual_machines/advanced_vm_management/virt-configuring-vgpu-passthrough.adoc
@@ -22,4 +22,4 @@ include::modules/virt-assign-vgpu-passthrough-to-vm.adoc[leveloffset=+1]
 [role="_additional-resources"]
 [id="additional-resources_virt-configuring-vgpu-passthrough"]
 == Additional resources
-* xref:../../../virt/virtual_machines/virt-create-vms.adoc#virt-create-vms[Creating virtual machines]
+* xref:../../../virt/virtual_machines/virt-creating-vms.adoc#virt-creating-vms[Creating virtual machines]
diff --git a/virt/virtual_machines/virt-automating-windows-sysprep.adoc b/virt/virtual_machines/virt-automating-windows-sysprep.adoc
@@ -19,7 +19,7 @@ include::modules/virt-specializing-windows-sysprep.adoc[leveloffset=+1]
 [role="_additional-resources"]
 [id="additional-resources-virt-automating-windows-sysprep_{context}"]
 == Additional resources
-* xref:../../virt/virtual_machines/virt-create-vms.adoc#virt-create-vms[Creating virtual machines]
+* xref:../../virt/virtual_machines/virt-creating-vms.adoc#virt-creating-vms[Creating virtual machines]
 * xref:../../virt/virtual_machines/virt-installing-qemu-guest-agent.adoc#virt-installing-qemu-guest-agent[Installing the QEMU guest agent and VirtIO drivers]
 * link:https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/sysprep\--generalize\--a-windows-installation[Microsoft, Sysprep (Generalize) a Windows installation]
 * link:https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/generalize[Microsoft, generalize]
diff --git a/virt/virtual_machines/virt-create-vms.adoc b/virt/virtual_machines/virt-create-vms.adoc
diff --git a/virt/virtual_machines/virt-creating-vms.adoc b/virt/virtual_machines/virt-creating-vms.adoc
@@ -0,0 +1,57 @@
+:_content-type: ASSEMBLY
+[id="virt-creating-vms"]
+= Creating virtual machines
+include::_attributes/common-attributes.adoc[]
+:context: virt-creating-vms
+:toclevels: 3
+
+toc::[]
+
+You can create virtual machines (VMs) from templates, instance types, and `VirtualMachine` manifests.
+
+[IMPORTANT]
+====
+Do not create VMs in the default `openshift-*` namespaces. Instead, create a new namespace or use an existing namespace without the `openshift` prefix.
+====
+
+Cluster administrators can enable automatic subscription for {op-system-base-full} virtual machines in the {VirtProductName} xref:../../virt/getting_started/virt-web-console-overview.adoc#overview-settings-cluster_virt-web-console-overview[web console].
+
+[id="creating-vms-from-templates"]
+== Creating VMs from templates
+
+You can create virtual machines (VMs) from templates by using the {product-title} web console.
+
+Boot sources::
+You can expedite virtual machine (VM) creation by using templates that have an available boot source. Templates with a boot source are labeled *Available boot source* if they do not have a custom label.
++
+Templates without a boot source are labeled *Boot source required*. You can use these templates if you complete the steps for xref:../../virt/virtual_machines/virt-creating-and-using-boot-sources.adoc#virt-adding-a-boot-source-web_virt-creating-and-using-boot-sources[adding a boot source to a VM].
+
+Customization::
+You can customize the disk source and VM parameters before you start the VM:
+
+* See xref:../../virt/virtual_machines/virt-creating-vms.adoc#virt-vm-storage-volume-types_virt-creating-vms[storage volume types] and xref:../../virt/virtual_machines/virt-creating-vms.adoc#virt-storage-wizard-fields-web_virt-creating-vms[storage fields] for details about disk source settings.
+
+* See the xref:../../virt/getting_started/virt-web-console-overview.adoc#virtualmachine-details-overview_virt-web-console-overview[*Overview*], xref:../../virt/getting_started/virt-web-console-overview.adoc#virtualmachine-details-yaml_virt-web-console-overview[*YAML*], and xref:../../virt/getting_started/virt-web-console-overview.adoc#virtualmachine-details-configuration_virt-web-console-overview[*Configuration*] tab documentation for details about VM settings.
+
+{sno-caps}::
+Due to differences in storage behavior, some templates are incompatible with {sno}. To ensure compatibility, do not set the `evictionStrategy` field for templates or VMs that use data volumes or storage profiles.
+
+include::modules/virt-creating-vm-from-template.adoc[leveloffset=+2]
+
+include::modules/virt-vm-storage-volume-types.adoc[leveloffset=+3]
+
+:virtualmachine:
+include::modules/virt-storage-wizard-fields-web.adoc[leveloffset=+3]
+:!virtualmachine:
+
+include::modules/virt-creating-vm-instancetype.adoc[leveloffset=+1]
+
+include::modules/virt-creating-vm-cli.adoc[leveloffset=+1]
+
+[id="additional-resources_virt-creating-vms_{context}"]
+[role="_additional-resources"]
+== Additional resources
+* xref:../../scalability_and_performance/using-cpu-manager.adoc#using-cpu-manager[Enabling CPU Manager for high performance workloads].
+* xref:../../virt/virtual_machines/virtual_disks/virt-using-container-disks-with-vms.adoc#virt-using-container-disks-with-vms[Preparing a container disk].
+* xref:../../machine_management/deploying-machine-health-checks.adoc#machine-health-checks-about_deploying-machine-health-checks[Deploying machine health checks].
+* xref:../../virt/virtual_machines/virtual_disks/virt-creating-data-volumes.adoc#virt-customizing-storage-profile_virt-creating-data-volumes[Customizing the storage profile].
diff --git a/virt/virtual_machines/virtual_disks/virt-using-container-disks-with-vms.adoc b/virt/virtual_machines/virtual_disks/virt-using-container-disks-with-vms.adoc
@@ -27,5 +27,5 @@ include::modules/virt-disabling-tls-for-registry.adoc[leveloffset=+1]
 == Next steps
 
 * xref:../../../virt/virtual_machines/importing_vms/virt-importing-virtual-machine-images-datavolumes.adoc#virt-importing-virtual-machine-images-datavolumes[Import the container disk into persistent storage for a virtual machine].
-* xref:../../../virt/virtual_machines/virt-create-vms.adoc#virt-create-vms[Create a virtual machine] that uses
+* xref:../../../virt/virtual_machines/virt-creating-vms.adoc#virt-creating-vms[Create a virtual machine] that uses
 a `containerDisk` volume for ephemeral storage.
