CNV-94223: Document the custom configuration workflow for creating a VM

_topic_maps/_topic_map.yml

@@ -4898,6 +4898,10 @@ Topics:
 - Name: Creating virtual machines
   Dir: creating_vm
   Topics:
+  # Web console procedures (unified wizard — CNV-94223, CNV-94224, CNV-94225, CNV-94226)
+  # Uncomment when CNV-94227 cleanup is complete:
+  #- Name: Create virtual machines by using the web console
+  #  File: virt-creating-vms-web
   # CLI procedures (existing content, moved from Chapter 8)
   - Name: Creating virtual machines by using the CLI
     File: virt-creating-vms-from-cli

modules/virt-creating-vm-custom-configuration-web.adoc

@@ -0,0 +1,62 @@
+// Module included in the following assemblies:
+//
+// * virt/creating_vm/virt-creating-vms-web.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-creating-vm-custom-configuration-web_{context}"]
+= Create a VM with custom configuration by using the web console
+
+[role="_abstract"]
+You can use the *Custom configuration* workflow in the web console to create a virtual machine (VM) by selecting a guest operating system, boot source, compute resources, and advanced settings.
+
+Use this workflow when:
+
+* No existing template matches your requirements.
+* You need a specific combination of compute, storage, and network settings.
+* You want to boot from a custom disk image.
+
+.Prerequisites
+
+* You have access to the {product-title} web console.
+* You have `edit` or `admin` permissions in the target project.
+
+.Procedure
+
+. In the {product-title} web console, navigate to *Virtualization* -> *VirtualMachines*.
+. Click *Create*.
+. On the *Deployment details* page, select the creation method, enter general information, and define the location:
+.. Select *Custom configuration*.
+.. In the *Name* field, enter a name for the VM. You can also click the refresh icon to generate a name automatically.
+.. Optional: Enter a *Description* for the VM.
+.. Review the *Location* to verify the target cluster and project. If the folder preview feature is enabled, you can also verify the folder. To change the location, click the edit icon.
+.. Click *Next*.
+. On the *Guest operating system* page, specify the operating system:
+.. Select the guest operating system, such as *RHEL*, *Microsoft Windows*, or *Other Linux*.
+.. Select the operating system version from the *Guest operating system type* list.
+.. Click *Next*.
+. On the *Boot source* page, specify the boot volume:
+.. Select *Boot volume* to use an existing boot volume or add a new one, or select *No boot source* to assign an empty disk that you can configure later.
+.. If you selected *Boot volume*, select an existing volume from the list, or click *Add volume* to configure a new boot volume.
+.. Click *Next*.
+. On the *Compute resources* page, define the instance type:
+.. Select an instance type series, such as *General purpose* or *Compute Exclusive*.
+.. Select the vCPU and memory size from the drop-down list.
+.. Click *Next*.
+. On the *Customization* page, optionally configure advanced settings by navigating the following tabs:
++
+* *Details*: Configure the *Hostname*, *Headless mode*, *Guest system log access*, and *Deletion protection*.
+* *Storage*: Add or modify storage disks.
+* *Network*: Add network interfaces.
+* *Scheduling*: Configure scheduling requirements and the run strategy.
+* *SSH*: Configure SSH key settings.
+* *Initial run*: Define *Cloud-init* or *Sysprep* initialization scripts.
+* *Labels and annotations*: Add labels to help organize and categorize VMs, and use annotations to store extra metadata.
++
+.. Click *Next*.
+. On the *Review and create* page, review the VM configuration:
+.. Optional: Select the *Start this VirtualMachine after creation* checkbox.
+.. Click *Create VirtualMachine*.
+
+.Verification
+
+* Navigate to *Virtualization* -> *VirtualMachines* and verify that the VM appears in the list.

virt/creating_vm/virt-creating-vms-web.adoc

@@ -0,0 +1,19 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="virt-creating-vms-web"]
+= Create virtual machines by using the web console
+include::_attributes/common-attributes.adoc[]
+:context: virt-creating-vms-web
+
+toc::[]
+
+[role="_abstract"]
+You can create virtual machines (VMs) by using the {product-title} web console. The web console creation wizard provides workflows for custom configuration, creating a VM from a template, and cloning an existing VM.
+
+// Custom configuration procedure (CNV-94223)
+include::modules/virt-creating-vm-custom-configuration-web.adoc[leveloffset=+1]
+
+// Template-based creation procedure (CNV-94224)
+
+// Clone existing VM procedure (CNV-94225)
+
+// VM creation considerations reference (CNV-94226)