Chapter 9. Virtual machine templates

Procedure

1. In the OpenShift Virtualization console, click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. Identify the virtual machine template for which you want to configure a boot source and click Add source.
4. In the Add boot source to template window, click Select boot source, select a method for creating a persistent volume claim (PVC): Upload local file, Import via URL, Clone existing PVC, or Import via Registry.
5. Optional: Click This is a CD-ROM boot source to mount a CD-ROM and use it to install the operating system on to an empty disk. The additional empty disk is automatically created and mounted by OpenShift Virtualization. If the additional disk is not needed, you can remove it when you create the virtual machine.

6. Enter a value for Persistent Volume Claim size to specify the PVC size that is adequate for the uncompressed image and any additional space that is required.

   1. Optional: Enter a name for Source provider to associate the name with this template.

   2. Optional: Advanced Storage settings: Click Storage class and select the storage class that is used to create the disk. Typically, this storage class is the default storage class that is created for use by all PVCs.

      Note

      Provided boot sources are updated automatically to the latest version of the operating system. For auto-updated boot sources, persistent volume claims (PVCs) are created with the cluster’s default storage class. If you select a different default storage class after configuration, you must delete the existing data volumes in the cluster namespace that are configured with the previous default storage class.

   3. Optional: Advanced Storage settings: Click Access mode and select an access mode for the persistent volume:

      • Single User (RWO) mounts the volume as read-write by a single node.
      • Shared Access (RWX) mounts the volume as read-write by many nodes.
      • Read Only (ROX) mounts the volume as read-only by many nodes.
   4. Optional: Advanced Storage settings: Click Volume mode if you want to select Block instead of the default value Filesystem. OpenShift Virtualization can statically provision raw block volumes. These volumes do not have a file system, and can provide performance benefits for applications that either write to the disk directly or implement their own storage service.

7. Select the appropriate method to save your boot source:

   1. Click Save and upload if you uploaded a local file.
   2. Click Save and import if you imported content from a URL or the registry.
   3. Click Save and clone if you cloned an existing PVC.

Procedure

1. In the OpenShift Virtualization console, click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. Identify the Red Hat template that you want to mark as a favorite.
4. Click the Options menu and select Favorite template. The template moves up higher in the list of displayed templates.

Procedure

1. In the OpenShift Virtualization console, click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. To filter templates, click Filter.
4. Select the appropriate checkbox from the list to filter the templates: Red Hat Supported, User Supported, Red Hat Provided, and User Provided.

Procedure

1. In the OpenShift Virtualization console, click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. Click Create and select Template with Wizard.
4. Fill in all required fields in the General step.

5. Click Next to progress to the Networking step. A NIC that is named nic0 is attached by default.

   1. Optional: Click Add Network Interface to create additional NICs.
   2. Optional: You can remove any or all NICs by clicking the Options menu and selecting Delete. Virtual machines created from a template do not need a NIC attached. NICs can be created after a virtual machine has been created.
6. Click Next to progress to the Storage step.

7. Click Add Disk to add a disk, and complete your selections for the fields in the Add Disk screen.

   Note

   If Import via URL (creates PVC), Import via Registry (creates PVC), or Container (ephemeral) is selected as Source, a rootdisk disk is created and attached to the virtual machine as the Bootable Disk.

   A Bootable Disk is not required for virtual machines provisioned from a PXE source if there are no disks attached to the virtual machine. If one or more disks are attached to the virtual machine, you must select one as the Bootable Disk.

   Blank disks, PVC disks without a valid boot source, and the cloudinitdisk cannot be used as a boot source.

8. Optional: Click Advanced to configure cloud-init and SSH access.

   Note

   Statically inject an SSH key by using the custom script in cloud-init or in the wizard. This allows you to securely and remotely manage virtual machines and manage and transfer information. This step is strongly recommended to secure your VM. 

9. Click Review to review and confirm your settings.
10. Click Create Virtual Machine template.
11. Click See virtual machine template details to view details about the virtual machine template.

Procedure

1. Click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. Select a virtual machine template.
4. Click the VM Template Details tab.
5. Click the pencil icon to make a field editable.
6. Make the relevant changes and click Save.

Procedure

1. In the OpenShift Virtualization console, click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. Select a template to open the VM Template Details screen.
4. Click the YAML tab to display the editable configuration.
5. Edit the file and click Save.

Procedure

1. Click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. Select a virtual machine template to open the VM Template Details screen.
4. Click the Disks tab.

5. In the Add Disk window, specify the Source, Name, Size, Type, Interface, and Storage Class.

   1. Advanced: You can enable preallocation if you use a blank disk source and require maximum write performance when creating data volumes. To do so, select the Enable preallocation checkbox.
   2. Optional: In the Advanced list, specify the Volume Mode and Access Mode for the virtual disk. If you do not specify these parameters, the system uses the default values from the kubevirt-storage-class-defaults config map.
6. Click Add.

Procedure

1. Click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. Select a virtual machine template to open the VM Template Details screen.
4. Click the Network Interfaces tab.
5. Click Add Network Interface.
6. In the Add Network Interface window, specify the Name, Model, Network, Type, and MAC Address of the network interface.
7. Click Add.

Procedure

1. Click Workloads Virtualization from the side menu.
2. Click the Templates tab.
3. Select a virtual machine template to open the VM Template Details screen.
4. Click the Disks tab.
5. Click the Options menu for the CD-ROM that you want to edit and select Edit.
6. In the Edit CD-ROM window, edit the fields: Source, Persistent Volume Claim, Name, Type, and Interface.
7. Click Save.

Procedure

1. Click Workloads Virtual Machine Templates from the side menu.
2. Select a virtual machine template to open the Virtual Machine Template tab.
3. Click the Details tab.
4. Click the pencil icon to the right of the Dedicated Resources field to open the Dedicated Resources window.
5. Select Schedule this workload with dedicated resources (guaranteed policy).
6. Click Save.

Procedure

1. In the OpenShift Virtualization console, click Workloads Virtualization from the side menu.

2. Click the Templates tab. Select the appropriate method to delete a virtual machine template:

   • Click the Options menu of the template to delete and select Delete Template.
   • Click the template name to open the Virtual Machine Template Details screen and click Actions Delete Template.
3. In the confirmation pop-up window, click Delete to permanently delete the template.