From a29210d8fba2fa16b0c137cd5a7502db22cd0321 Mon Sep 17 00:00:00 2001 From: Miriam Weiss Date: Mon, 3 Aug 2026 10:31:25 +0300 Subject: [PATCH 1/4] CNV-94223: Document the custom configuration workflow for creating a VM --- _topic_maps/_topic_map.yml | 4 ++ ...-creating-vm-custom-configuration-web.adoc | 54 +++++++++++++++++++ virt/creating_vm/virt-cloning-vms-web.adoc | 12 ----- ...creating-vms-custom-configuration-web.adoc | 12 ----- .../virt-creating-vms-from-template-web.adoc | 12 ----- virt/creating_vm/virt-creating-vms-web.adoc | 19 +++++++ .../virt-vm-creation-considerations-web.adoc | 12 ----- 7 files changed, 77 insertions(+), 48 deletions(-) create mode 100644 modules/virt-creating-vm-custom-configuration-web.adoc delete mode 100644 virt/creating_vm/virt-cloning-vms-web.adoc delete mode 100644 virt/creating_vm/virt-creating-vms-custom-configuration-web.adoc delete mode 100644 virt/creating_vm/virt-creating-vms-from-template-web.adoc create mode 100644 virt/creating_vm/virt-creating-vms-web.adoc delete mode 100644 virt/creating_vm/virt-vm-creation-considerations-web.adoc diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 22d744080bd7..8d98645a6bd0 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -4893,6 +4893,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 diff --git a/modules/virt-creating-vm-custom-configuration-web.adoc b/modules/virt-creating-vm-custom-configuration-web.adoc new file mode 100644 index 000000000000..f3e309f3219c --- /dev/null +++ b/modules/virt-creating-vm-custom-configuration-web.adoc @@ -0,0 +1,54 @@ +// 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, when you need a specific combination of compute, storage, and network settings, or when you want to boot from a custom disk image. + +.Prerequisites + +* You have access to the {product-title} web console. +* You have the required permissions to create VMs 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 and location: +.. Select *Custom configuration*. +.. Review the *Location* to verify the target cluster, project, and folder. To change the location, click the edit icon. +.. Click *Next*. +. On the *Guest OS* 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 source* 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 source*, select an existing volume from the list, or click *Add boot source* 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 *Select size* 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 additional network interfaces. +* *SSH*: Configure SSH key settings. +* *Scheduling*: Configure scheduling requirements and the run strategy. +* *Initial run*: Define cloud-init or Sysprep initialization scripts. +* *Metadata*: Add labels and annotations. ++ +Click *Next*. +. On the *Review and create* page, review the VM configuration: +.. In the *Name* field, accept the auto-generated name or enter a custom name. +.. Optional: Enter a *Description* for the VM. +.. Optional: Select the *Start this VirtualMachine after creation* checkbox. +.. Click *Create VirtualMachine*. diff --git a/virt/creating_vm/virt-cloning-vms-web.adoc b/virt/creating_vm/virt-cloning-vms-web.adoc deleted file mode 100644 index 3a7eac10e2e9..000000000000 --- a/virt/creating_vm/virt-cloning-vms-web.adoc +++ /dev/null @@ -1,12 +0,0 @@ -:_mod-docs-content-type: ASSEMBLY -[id="virt-cloning-vms-web"] -= Cloning a virtual machine by using the web console -include::_attributes/common-attributes.adoc[] -:context: virt-cloning-vms-web - -toc::[] - -[role="_abstract"] -You can clone a virtual machine (VM) by using the {product-title} web console creation wizard. - -// Phase 2 content goes here (CNV-94225) diff --git a/virt/creating_vm/virt-creating-vms-custom-configuration-web.adoc b/virt/creating_vm/virt-creating-vms-custom-configuration-web.adoc deleted file mode 100644 index 787bab231af5..000000000000 --- a/virt/creating_vm/virt-creating-vms-custom-configuration-web.adoc +++ /dev/null @@ -1,12 +0,0 @@ -:_mod-docs-content-type: ASSEMBLY -[id="virt-creating-vms-custom-configuration-web"] -= Creating a VM with custom configuration by using the web console -include::_attributes/common-attributes.adoc[] -:context: virt-creating-vms-custom-configuration-web - -toc::[] - -[role="_abstract"] -You can create a virtual machine (VM) with custom configuration by using the {product-title} web console creation wizard. - -// Phase 2 content goes here (CNV-94223) diff --git a/virt/creating_vm/virt-creating-vms-from-template-web.adoc b/virt/creating_vm/virt-creating-vms-from-template-web.adoc deleted file mode 100644 index 4989f9fcb91b..000000000000 --- a/virt/creating_vm/virt-creating-vms-from-template-web.adoc +++ /dev/null @@ -1,12 +0,0 @@ -:_mod-docs-content-type: ASSEMBLY -[id="virt-creating-vms-from-template-web"] -= Creating a VM from a template by using the web console -include::_attributes/common-attributes.adoc[] -:context: virt-creating-vms-from-template-web - -toc::[] - -[role="_abstract"] -You can create a virtual machine (VM) from a template by using the {product-title} web console creation wizard. - -// Phase 2 content goes here (CNV-94224) diff --git a/virt/creating_vm/virt-creating-vms-web.adoc b/virt/creating_vm/virt-creating-vms-web.adoc new file mode 100644 index 000000000000..7d86a0d5f32d --- /dev/null +++ b/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) diff --git a/virt/creating_vm/virt-vm-creation-considerations-web.adoc b/virt/creating_vm/virt-vm-creation-considerations-web.adoc deleted file mode 100644 index a6e727845c11..000000000000 --- a/virt/creating_vm/virt-vm-creation-considerations-web.adoc +++ /dev/null @@ -1,12 +0,0 @@ -:_mod-docs-content-type: ASSEMBLY -[id="virt-vm-creation-considerations-web"] -= VM creation considerations -include::_attributes/common-attributes.adoc[] -:context: virt-vm-creation-considerations-web - -toc::[] - -[role="_abstract"] -Review important considerations, terminology, and configuration details before creating virtual machines (VMs) by using the web console. - -// Phase 2 content goes here (CNV-94226) From 47151ee6d644024b1030bcc7da5a4393f41a9731 Mon Sep 17 00:00:00 2001 From: Miriam Weiss Date: Mon, 3 Aug 2026 10:48:42 +0300 Subject: [PATCH 2/4] CNV-94223: Move VM name and description to Deployment details step In 4.22.2, the wizard moved the name and description fields from the Review and create page to the Deployment details page. The name field is now empty by default instead of auto-generated. Co-Authored-By: Claude Opus 4.6 --- modules/virt-creating-vm-custom-configuration-web.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/virt-creating-vm-custom-configuration-web.adoc b/modules/virt-creating-vm-custom-configuration-web.adoc index f3e309f3219c..e3d13ccdfc86 100644 --- a/modules/virt-creating-vm-custom-configuration-web.adoc +++ b/modules/virt-creating-vm-custom-configuration-web.adoc @@ -20,9 +20,11 @@ Use this workflow when no existing template matches your requirements, when you . In the {product-title} web console, navigate to *Virtualization* -> *VirtualMachines*. . Click *Create*. -. On the *Deployment details* page, select the creation method and location: +. On the *Deployment details* page, select the creation method, location, and VM identity: .. Select *Custom configuration*. .. Review the *Location* to verify the target cluster, project, and folder. To change the location, click the edit icon. +.. 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. .. Click *Next*. . On the *Guest OS* page, specify the operating system: .. Select the guest operating system, such as *RHEL*, *Microsoft Windows*, or *Other Linux*. @@ -48,7 +50,5 @@ Use this workflow when no existing template matches your requirements, when you + Click *Next*. . On the *Review and create* page, review the VM configuration: -.. In the *Name* field, accept the auto-generated name or enter a custom name. -.. Optional: Enter a *Description* for the VM. .. Optional: Select the *Start this VirtualMachine after creation* checkbox. .. Click *Create VirtualMachine*. From c6ea186a131b559e83b83ac7faba7eb2de103255 Mon Sep 17 00:00:00 2001 From: Miriam Weiss Date: Mon, 3 Aug 2026 11:57:55 +0300 Subject: [PATCH 3/4] CNV-94223: Fix UI labels and tab order in custom configuration procedure Update UI element names to match the current web console: correct radio button labels, bold labeled UI elements, fix tab ordering, and use generic description for unlabeled drop-down per Red Hat SSG. Co-Authored-By: Claude Opus 4.6 --- ...-creating-vm-custom-configuration-web.adoc | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/modules/virt-creating-vm-custom-configuration-web.adoc b/modules/virt-creating-vm-custom-configuration-web.adoc index e3d13ccdfc86..a03308ee2430 100644 --- a/modules/virt-creating-vm-custom-configuration-web.adoc +++ b/modules/virt-creating-vm-custom-configuration-web.adoc @@ -20,33 +20,33 @@ Use this workflow when no existing template matches your requirements, when you . In the {product-title} web console, navigate to *Virtualization* -> *VirtualMachines*. . Click *Create*. -. On the *Deployment details* page, select the creation method, location, and VM identity: +. On the *Deployment details* page, select the creation method, enter general information, and define the location: .. Select *Custom configuration*. -.. Review the *Location* to verify the target cluster, project, and folder. To change the location, click the edit icon. .. 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, project, and folder. To change the location, click the edit icon. .. Click *Next*. -. On the *Guest OS* page, specify the operating system: +. 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 source* 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 source*, select an existing volume from the list, or click *Add boot source* to configure a new 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 *Select size* list. +.. 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. +* *Details*: Configure the *Hostname*, *Headless mode*, *Guest system log access*, and *Deletion protection*. * *Storage*: Add or modify storage disks. * *Network*: Add additional network interfaces. -* *SSH*: Configure SSH key settings. * *Scheduling*: Configure scheduling requirements and the run strategy. -* *Initial run*: Define cloud-init or Sysprep initialization scripts. -* *Metadata*: Add labels and annotations. +* *SSH*: Configure SSH key settings. +* *Initial run*: Define *Cloud-init* or *Sysprep* initialization scripts. +* *Metadata*: Add *Labels* and *Annotations*. + Click *Next*. . On the *Review and create* page, review the VM configuration: From 6c830225aeb49d39ed0d0a12f6fe788ccd960c7f Mon Sep 17 00:00:00 2001 From: Miriam Weiss Date: Mon, 3 Aug 2026 12:18:25 +0300 Subject: [PATCH 4/4] CNV-94223: Temporarily uncomment assembly in topic map for preview Co-Authored-By: Claude Opus 4.6 --- _topic_maps/_topic_map.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 8d98645a6bd0..3bef75e436a1 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -4895,8 +4895,8 @@ Topics: 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 + - 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