#VirtualMachineClusterPreference [virtualmachineclusterpreferences.instancetype.kubevirt.io/v1beta1]

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

Required spec describing the preferences

Optionally defines preferred Annotations to be applied to the VirtualMachineInstance

Clock optionally defines preferences associated with the Clock attribute of a VirtualMachineInstance DomainSpec

CPU optionally defines preferences associated with the CPU attribute of a VirtualMachineInstance DomainSpec

Devices optionally defines preferences associated with the Devices attribute of a VirtualMachineInstance DomainSpec

Features optionally defines preferences associated with the Features attribute of a VirtualMachineInstance DomainSpec

Firmware optionally defines preferences associated with the Firmware attribute of a VirtualMachineInstance DomainSpec

Machine optionally defines preferences associated with the Machine attribute of a VirtualMachineInstance DomainSpec

PreferSpreadSocketToCoreRatio defines the ratio to spread vCPUs between cores and sockets, it defaults to 2.

PreferredArchitecture defines a prefeerred architecture for the VirtualMachine

Subdomain of the VirtualMachineInstance

Grace period observed after signalling a VirtualMachineInstance to stop after which the VirtualMachineInstance is force terminated.

Requirements defines the minium amount of instance type defined resources required by a set of preferences

Volumes optionally defines preferences associated with the Volumes attribute of a VirtualMachineInstace DomainSpec

ClockOffset allows specifying the UTC offset or the timezone of the guest clock.

Timer specifies whih timers are attached to the vmi.

Timezone sets the guest clock to the specified timezone. Zone name follows the TZ environment variable format (e.g. 'America/New_York').

UTC sets the guest clock to UTC on each boot. If an offset is specified, guest changes to the clock will be kept during reboots and are not reset.

OffsetSeconds specifies an offset in seconds, relative to UTC. If set, guest changes to the clock will be kept during reboots and not reset.

HPET (High Precision Event Timer) - multiple timers with periodic interrupts.

Hyperv (Hypervclock) - lets guests read the host’s wall clock time (paravirtualized). For windows guests.

KVM (KVM clock) - lets guests read the host’s wall clock time (paravirtualized). For linux guests.

PIT (Programmable Interval Timer) - a timer with periodic interrupts.

RTC (Real Time Clock) - a continuously running timer with periodic interrupts.

Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.

TickPolicy determines what happens when QEMU misses a deadline for injecting a tick to the guest. One of "delay", "catchup", "merge", "discard".

Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.

Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.

Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.

TickPolicy determines what happens when QEMU misses a deadline for injecting a tick to the guest. One of "delay", "catchup", "discard".

Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.

TickPolicy determines what happens when QEMU misses a deadline for injecting a tick to the guest. One of "delay", "catchup".

Track the guest or the wall clock.

PreferredCPUFeatures optionally defines a slice of preferred CPU features.

PreferredCPUTopology optionally defines the preferred guest visible CPU topology, defaults to PreferSockets.

Name of the CPU feature

Policy is the CPU feature attribute which can have the following attributes: force - The virtual CPU will claim the feature is supported regardless of it being supported by host CPU. require - Guest creation will fail unless the feature is supported by the host CPU or the hypervisor is able to emulate it. optional - The feature will be supported by virtual CPU if and only if it is supported by host CPU. disable - The feature will not be supported by virtual CPU. forbid - Guest creation will fail if the feature is supported by host CPU. Defaults to require

Across optionally defines how to spread vCPUs across the guest visible topology. Default: SocketsCores

Ratio optionally defines the ratio to spread vCPUs across the guest visible topology:

CoresThreads - 1:2 - Controls the ratio of cores to threads. Only a ratio of 2 is currently accepted. SocketsCores - 1:N - Controls the ratio of socket to cores. SocketsCoresThreads - 1:N:2 - Controls the ratio of socket to cores. Each core providing 2 threads.

Default: 2

PreferredAutoattachGraphicsDevice optionally defines the preferred value of AutoattachGraphicsDevice

PreferredAutoattachInputDevice optionally defines the preferred value of AutoattachInputDevice

PreferredAutoattachMemBalloon optionally defines the preferred value of AutoattachMemBalloon

PreferredAutoattachPodInterface optionally defines the preferred value of AutoattachPodInterface

PreferredAutoattachSerialConsole optionally defines the preferred value of AutoattachSerialConsole

PreferredBlockMultiQueue optionally enables the vhost multiqueue feature for virtio disks.

PreferredCdromBus optionally defines the preferred bus for Cdrom Disk devices.

PreferredDisableHotplug optionally defines the preferred value of DisableHotplug

PreferredBlockSize optionally defines the block size of Disk devices.

PreferredDiskBus optionally defines the preferred bus for Disk Disk devices.

PreferredCache optionally defines the DriverCache to be used by Disk devices.

PreferredDedicatedIoThread optionally enables dedicated IO threads for Disk devices using the virtio bus.

PreferredIo optionally defines the QEMU disk IO mode to be used by Disk devices.

PreferredInputBus optionally defines the preferred bus for Input devices.

PreferredInputType optionally defines the preferred type for Input devices.

PreferredInterfaceMasquerade optionally defines the preferred masquerade configuration to use with each network interface.

PreferredInterfaceModel optionally defines the preferred model to be used by Interface devices.

PreferredLunBus optionally defines the preferred bus for Lun Disk devices.

PreferredNetworkInterfaceMultiQueue optionally enables the vhost multiqueue feature for virtio interfaces.

PreferredPanicDeviceModel optionally defines the preferred panic device model to use with panic devices.

PreferredRng optionally defines the preferred rng device to be used.

PreferredSoundModel optionally defines the preferred model for Sound devices.

PreferredTPM optionally defines the preferred TPM device to be used.

PreferredUseVirtioTransitional optionally defines the preferred value of UseVirtioTransitional

PreferredVirtualGPUOptions optionally defines the preferred value of VirtualGPUOptions

CustomBlockSize represents the desired logical and physical block size for a VM disk.

Represents if a feature is enabled or disabled.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled allows a user to explicitly disable the vTPM even when one is enabled by a preference referenced by the VirtualMachine Defaults to True

Persistent indicates the state of the TPM device should be kept accross reboots Defaults to false

Enabled determines if a display addapter backed by a vGPU should be enabled or disabled on the guest. Defaults to true.

Enables a boot framebuffer, until the guest OS loads a real GPU driver Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

PreferredAcpi optionally enables the ACPI feature

PreferredApic optionally enables and configures the APIC feature

PreferredHyperv optionally enables and configures HyperV features

PreferredKvm optionally enables and configures KVM features

PreferredPvspinlock optionally enables the Pvspinlock feature

PreferredSmm optionally enables the SMM feature

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

EndOfInterrupt enables the end of interrupt notification in the guest. Defaults to false.

EVMCS Speeds up L2 vmexits, but disables other virtualization features. Requires vapic. Defaults to the machine type setting.

Frequencies improves the TSC clock source handling for Hyper-V on KVM. Defaults to the machine type setting.

IPI improves performances in overcommited environments. Requires vpindex. Defaults to the machine type setting.

Reenlightenment enables the notifications on TSC frequency changes. Defaults to the machine type setting.

Relaxed instructs the guest OS to disable watchdog timeouts. Defaults to the machine type setting.

Reset enables Hyperv reboot/reset for the vmi. Requires synic. Defaults to the machine type setting.

Runtime improves the time accounting to improve scheduling in the guest. Defaults to the machine type setting.

Spinlocks allows to configure the spinlock retry attempts.

SyNIC enables the Synthetic Interrupt Controller. Defaults to the machine type setting.

SyNICTimer enables Synthetic Interrupt Controller Timers, reducing CPU load. Defaults to the machine type setting.

TLBFlush improves performances in overcommited environments. Requires vpindex. Defaults to the machine type setting.

VAPIC improves the paravirtualized handling of interrupts. Defaults to the machine type setting.

VendorID allows setting the hypervisor vendor id. Defaults to the machine type setting.

VPIndex enables the Virtual Processor Index to help windows identifying virtual processors. Defaults to the machine type setting.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Retries indicates the number of retries. Must be a value greater or equal 4096. Defaults to 4096.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Represents if a feature is enabled or disabled.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

VendorID sets the hypervisor vendor id, visible to the vmi. String up to twelve characters.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Hide the KVM hypervisor from standard MSR based discovery. Defaults to false

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.

PreferredEfi optionally enables EFI

PreferredUseBios optionally enables BIOS

PreferredUseBiosSerial optionally transmitts BIOS output over the serial.

Requires PreferredUseBios to be enabled.

PreferredUseEfi optionally enables EFI

Deprecated: Will be removed with v1beta2 or v1

PreferredUseSecureBoot optionally enables SecureBoot and the OVMF roms will be swapped for SecureBoot-enabled ones.

Requires PreferredUseEfi and PreferredSmm to be enabled.

Deprecated: Will be removed with v1beta2 or v1

If set to true, Persistent will persist the EFI NVRAM across reboots. Defaults to false

If set, SecureBoot will be enabled and the OVMF roms will be swapped for SecureBoot-enabled ones. Requires SMM to be enabled. Defaults to true

PreferredMachineType optionally defines the preferred machine type to use.

Required Architecture of the VM referencing this preference

Required CPU related attributes of the instancetype.

Required Memory related attributes of the instancetype.

Minimal number of vCPUs required by the preference.

Minimal amount of memory required by the preference.

PreffereedStorageClassName optionally defines the preferred storageClass