Virtual Machine

A Virtual Machine (VM) simulates computer hardware, enabling various operating systems and applications to run in an isolated environment.

Deployment Details

The virtual machine is managed and hosted through KubeVirt, allowing you to harness the benefits of virtualization within your Kubernetes ecosystem.

Accessing virtual machine

You can access the virtual machine using the virtctl tool:

To access the serial console:

virtctl console <vm>

To access the VM using VNC:

virtctl vnc <vm>

To SSH into the VM:

virtctl ssh <user>@<vm>

Parameters

Common parameters

NameDescriptionValue
externalEnable external access from outside the clusterfalse
externalMethodspecify method to passthrough the traffic to the virtual machine. Allowed values: WholeIP and PortListWholeIP
externalPortsSpecify ports to forward from outside the cluster[]
runningDetermines if the virtual machine should be runningtrue
instanceTypeVirtual Machine instance typeu1.medium
instanceProfileVirtual Machine preferences profileubuntu
disksList of disks to attach[]
gpusList of GPUs to attach[]
resources.cpuThe number of CPU cores allocated to the virtual machine""
resources.memoryThe amount of memory allocated to the virtual machine""
sshKeysList of SSH public keys for authentication. Can be a single key or a list of keys.[]
cloudInitcloud-init user data config. See cloud-init documentation for more details.""
cloudInitSeedA seed string to generate an SMBIOS UUID for the VM.""

U Series

The U Series is quite neutral and provides resources for general purpose applications.

U is the abbreviation for “Universal”, hinting at the universal attitude towards workloads.

VMs of instance types will share physical CPU cores on a time-slice basis with other VMs.

U Series Characteristics

Specific characteristics of this series are:

  • Burstable CPU performance - The workload has a baseline compute performance but is permitted to burst beyond this baseline, if excess compute resources are available.
  • vCPU-To-Memory Ratio (1:4) - A vCPU-to-Memory ratio of 1:4, for less noise per node.

O Series

The O Series is based on the U Series, with the only difference being that memory is overcommitted.

O is the abbreviation for “Overcommitted”.

UO Series Characteristics

Specific characteristics of this series are:

  • Burstable CPU performance - The workload has a baseline compute performance but is permitted to burst beyond this baseline, if excess compute resources are available.
  • Overcommitted Memory - Memory is over-committed in order to achieve a higher workload density.
  • vCPU-To-Memory Ratio (1:4) - A vCPU-to-Memory ratio of 1:4, for less noise per node.

CX Series

The CX Series provides exclusive compute resources for compute intensive applications.

CX is the abbreviation of “Compute Exclusive”.

The exclusive resources are given to the compute threads of the VM. In order to ensure this, some additional cores (depending on the number of disks and NICs) will be requested to offload the IO threading from cores dedicated to the workload. In addition, in this series, the NUMA topology of the used cores is provided to the VM.

CX Series Characteristics

Specific characteristics of this series are:

  • Hugepages - Hugepages are used in order to improve memory performance.
  • Dedicated CPU - Physical cores are exclusively assigned to every vCPU in order to provide fixed and high compute guarantees to the workload.
  • Isolated emulator threads - Hypervisor emulator threads are isolated from the vCPUs in order to reduce emaulation related impact on the workload.
  • vNUMA - Physical NUMA topology is reflected in the guest in order to optimize guest sided cache utilization.
  • vCPU-To-Memory Ratio (1:2) - A vCPU-to-Memory ratio of 1:2.

M Series

The M Series provides resources for memory intensive applications.

M is the abbreviation of “Memory”.

M Series Characteristics

Specific characteristics of this series are:

  • Hugepages - Hugepages are used in order to improve memory performance.
  • Burstable CPU performance - The workload has a baseline compute performance but is permitted to burst beyond this baseline, if excess compute resources are available.
  • vCPU-To-Memory Ratio (1:8) - A vCPU-to-Memory ratio of 1:8, for much less noise per node.

RT Series

The RT Series provides resources for realtime applications, like Oslat.

RT is the abbreviation for “realtime”.

This series of instance types requires nodes capable of running realtime applications.

RT Series Characteristics

Specific characteristics of this series are:

  • Hugepages - Hugepages are used in order to improve memory performance.
  • Dedicated CPU - Physical cores are exclusively assigned to every vCPU in order to provide fixed and high compute guarantees to the workload.
  • Isolated emulator threads - Hypervisor emulator threads are isolated from the vCPUs in order to reduce emaulation related impact on the workload.
  • vCPU-To-Memory Ratio (1:4) - A vCPU-to-Memory ratio of 1:4 starting from the medium size.

Development

To get started with customizing or creating your own instancetypes and preferences see DEVELOPMENT.md.

Resources

The following instancetype resources are provided by Cozystack:

NamevCPUsMemory
cx1.2xlarge816Gi
cx1.4xlarge1632Gi
cx1.8xlarge3264Gi
cx1.large24Gi
cx1.medium12Gi
cx1.xlarge48Gi
gn1.2xlarge832Gi
gn1.4xlarge1664Gi
gn1.8xlarge32128Gi
gn1.xlarge416Gi
m1.2xlarge864Gi
m1.4xlarge16128Gi
m1.8xlarge32256Gi
m1.large216Gi
m1.xlarge432Gi
n1.2xlarge1632Gi
n1.4xlarge3264Gi
n1.8xlarge64128Gi
n1.large48Gi
n1.medium44Gi
n1.xlarge816Gi
o1.2xlarge832Gi
o1.4xlarge1664Gi
o1.8xlarge32128Gi
o1.large28Gi
o1.medium14Gi
o1.micro11Gi
o1.nano1512Mi
o1.small12Gi
o1.xlarge416Gi
rt1.2xlarge832Gi
rt1.4xlarge1664Gi
rt1.8xlarge32128Gi
rt1.large28Gi
rt1.medium14Gi
rt1.micro11Gi
rt1.small12Gi
rt1.xlarge416Gi
u1.2xlarge832Gi
u1.2xmedium24Gi
u1.4xlarge1664Gi
u1.8xlarge32128Gi
u1.large28Gi
u1.medium14Gi
u1.micro11Gi
u1.nano1512Mi
u1.small12Gi
u1.xlarge416Gi

The following preference resources are provided by Cozystack:

NameGuest OS
alpineAlpine
centos.7CentOS 7
centos.7.desktopCentOS 7
centos.stream10CentOS Stream 10
centos.stream10.desktopCentOS Stream 10
centos.stream8CentOS Stream 8
centos.stream8.desktopCentOS Stream 8
centos.stream8.dpdkCentOS Stream 8
centos.stream9CentOS Stream 9
centos.stream9.desktopCentOS Stream 9
centos.stream9.dpdkCentOS Stream 9
cirrosCirros
fedoraFedora (amd64)
fedora.arm64Fedora (arm64)
opensuse.leapOpenSUSE Leap
opensuse.tumbleweedOpenSUSE Tumbleweed
rhel.10Red Hat Enterprise Linux 10 Beta (amd64)
rhel.10.arm64Red Hat Enterprise Linux 10 Beta (arm64)
rhel.7Red Hat Enterprise Linux 7
rhel.7.desktopRed Hat Enterprise Linux 7
rhel.8Red Hat Enterprise Linux 8
rhel.8.desktopRed Hat Enterprise Linux 8
rhel.8.dpdkRed Hat Enterprise Linux 8
rhel.9Red Hat Enterprise Linux 9 (amd64)
rhel.9.arm64Red Hat Enterprise Linux 9 (arm64)
rhel.9.desktopRed Hat Enterprise Linux 9 Desktop (amd64)
rhel.9.dpdkRed Hat Enterprise Linux 9 DPDK (amd64)
rhel.9.realtimeRed Hat Enterprise Linux 9 Realtime (amd64)
slesSUSE Linux Enterprise Server
ubuntuUbuntu
windows.10Microsoft Windows 10
windows.10.virtioMicrosoft Windows 10 (virtio)
windows.11Microsoft Windows 11
windows.11.virtioMicrosoft Windows 11 (virtio)
windows.2k16Microsoft Windows Server 2016
windows.2k16.virtioMicrosoft Windows Server 2016 (virtio)
windows.2k19Microsoft Windows Server 2019
windows.2k19.virtioMicrosoft Windows Server 2019 (virtio)
windows.2k22Microsoft Windows Server 2022
windows.2k22.virtioMicrosoft Windows Server 2022 (virtio)
windows.2k25Microsoft Windows Server 2025
windows.2k25.virtioMicrosoft Windows Server 2025 (virtio)