topology

Documentation

Index

• Constants
• func AreTSCFrequencyTopologyHintsDefined(vmi *k6tv1.VirtualMachineInstance) bool
• func CalculateTSCLabelDiff(frequenciesInUse []int64, frequenciesOnNode []int64, nodeFrequency int64, ...) (toAdd []int64, toRemove []int64)
• func FilterNodesFromCache(objs []interface{}, predicates ...FilterPredicateFunc) []*v1.Node
• func HasInvTSCFrequency(node *v1.Node) bool
• func IsManualTSCFrequencyRequired(vmi *k6tv1.VirtualMachineInstance) bool
• func IsSchedulable(node *v1.Node) bool
• func LowestTSCFrequency(nodes []*v1.Node) int64
• func NewTopologyHinter(nodeStore cache.Store, vmiStore cache.Store, ...) *topologyHinter
• func TSCFrequenciesOnNode(node *v1.Node) (frequencies []int64)
• func TSCFrequencyFromNode(node *v1.Node) (frequency int64, scalable bool, err error)
• func TSCFrequencyFromPod(pod *v1.Pod) (frequency int64, err error)
• func ToTSCSchedulableLabel(frequency int64) string
• func ToTSCSchedulableLabels(frequencies []int64) (labels []string)
• func ToleranceForFrequency(freq int64) int64
• type FilterPredicateFunc
  • func IsNodeRunningVmis(vmiStore cache.Store) FilterPredicateFunc
  • func NodeOfVMI(vmi *virtv1.VirtualMachineInstance) FilterPredicateFunc
  • func Not(f FilterPredicateFunc) FilterPredicateFunc
  • func Or(predicates ...FilterPredicateFunc) FilterPredicateFunc
  • func TSCFrequencyGreaterEqual(frequency int64) FilterPredicateFunc
• type Hinter
• type MockHinter
  • func NewMockHinter(ctrl *gomock.Controller) *MockHinter
  • func (_m *MockHinter) EXPECT() *_MockHinterRecorder
  • func (_m *MockHinter) IsTscFrequencyRequired(vmi *v1.VirtualMachineInstance) bool
  • func (_m *MockHinter) LowestTSCFrequencyOnCluster() (int64, error)
  • func (_m *MockHinter) TSCFrequenciesInUse() []int64
  • func (_m *MockHinter) TopologyHintsForVMI(vmi *v1.VirtualMachineInstance) (*v1.TopologyHints, TscFrequencyRequirementType, error)
• type MockNodeTopologyUpdater
  • func NewMockNodeTopologyUpdater(ctrl *gomock.Controller) *MockNodeTopologyUpdater
  • func (_m *MockNodeTopologyUpdater) EXPECT() *_MockNodeTopologyUpdaterRecorder
  • func (_m *MockNodeTopologyUpdater) Run(interval time.Duration, stopChan <-chan struct{})
• type NodeTopologyUpdater
  • func NewNodeTopologyUpdater(clientset kubecli.KubevirtClient, hinter Hinter, ...) NodeTopologyUpdater
• type TscFrequencyRequirement
  • func GetTscFrequencyRequirement(vmi *k6tv1.VirtualMachineInstance) TscFrequencyRequirement
• type TscFrequencyRequirementType

Constants

const TSCFrequencyLabel = virtv1.CPUTimerLabel + "tsc-frequency"

const TSCFrequencySchedulingLabel = "scheduling.node.kubevirt.io/tsc-frequency"

const TSCScalableLabel = virtv1.CPUTimerLabel + "tsc-scalable"

const TSCTolerancePPM float64 = 250

Functions

func AreTSCFrequencyTopologyHintsDefined

func AreTSCFrequencyTopologyHintsDefined(vmi *k6tv1.VirtualMachineInstance) bool

func CalculateTSCLabelDiff

func CalculateTSCLabelDiff(frequenciesInUse []int64, frequenciesOnNode []int64, nodeFrequency int64, scalable bool) (toAdd []int64, toRemove []int64)

func FilterNodesFromCache

func FilterNodesFromCache(objs []interface{}, predicates ...FilterPredicateFunc) []*v1.Node

func HasInvTSCFrequency

func HasInvTSCFrequency(node *v1.Node) bool

func IsManualTSCFrequencyRequired

func IsManualTSCFrequencyRequired(vmi *k6tv1.VirtualMachineInstance) bool

func IsSchedulable

func IsSchedulable(node *v1.Node) bool

func LowestTSCFrequency

func LowestTSCFrequency(nodes []*v1.Node) int64

func NewTopologyHinter

func NewTopologyHinter(nodeStore cache.Store, vmiStore cache.Store, clusterConfig *virtconfig.ClusterConfig) *topologyHinter

func TSCFrequenciesOnNode

func TSCFrequenciesOnNode(node *v1.Node) (frequencies []int64)

func TSCFrequencyFromNode

func TSCFrequencyFromNode(node *v1.Node) (frequency int64, scalable bool, err error)

func TSCFrequencyFromPod

func TSCFrequencyFromPod(pod *v1.Pod) (frequency int64, err error)

func ToTSCSchedulableLabel

func ToTSCSchedulableLabel(frequency int64) string

func ToTSCSchedulableLabels

func ToTSCSchedulableLabels(frequencies []int64) (labels []string)

func ToleranceForFrequency

func ToleranceForFrequency(freq int64) int64

ToleranceForFrequency returns TSCTolerancePPM parts per million of freq, rounded down to the nearest Hz

Types

type FilterPredicateFunc

type FilterPredicateFunc func(node *v1.Node) bool

func IsNodeRunningVmis

func IsNodeRunningVmis(vmiStore cache.Store) FilterPredicateFunc

func NodeOfVMI

func NodeOfVMI(vmi *virtv1.VirtualMachineInstance) FilterPredicateFunc

func Not

func Not(f FilterPredicateFunc) FilterPredicateFunc

func Or

func Or(predicates ...FilterPredicateFunc) FilterPredicateFunc

func TSCFrequencyGreaterEqual

func TSCFrequencyGreaterEqual(frequency int64) FilterPredicateFunc

type Hinter

type Hinter interface {
	TopologyHintsForVMI(vmi *k6tv1.VirtualMachineInstance) (hints *k6tv1.TopologyHints, requirement TscFrequencyRequirementType, err error)
	IsTscFrequencyRequired(vmi *k6tv1.VirtualMachineInstance) bool
	TSCFrequenciesInUse() []int64
	LowestTSCFrequencyOnCluster() (int64, error)
}

type MockHinter

type MockHinter struct {
	// contains filtered or unexported fields
}

Mock of Hinter interface

func NewMockHinter

func NewMockHinter(ctrl *gomock.Controller) *MockHinter

func (*MockHinter) EXPECT

func (_m *MockHinter) EXPECT() *_MockHinterRecorder

func (*MockHinter) IsTscFrequencyRequired

func (_m *MockHinter) IsTscFrequencyRequired(vmi *v1.VirtualMachineInstance) bool

func (*MockHinter) LowestTSCFrequencyOnCluster

func (_m *MockHinter) LowestTSCFrequencyOnCluster() (int64, error)

func (*MockHinter) TSCFrequenciesInUse

func (_m *MockHinter) TSCFrequenciesInUse() []int64

func (*MockHinter) TopologyHintsForVMI

func (_m *MockHinter) TopologyHintsForVMI(vmi *v1.VirtualMachineInstance) (*v1.TopologyHints, TscFrequencyRequirementType, error)

type MockNodeTopologyUpdater

type MockNodeTopologyUpdater struct {
	// contains filtered or unexported fields
}

Mock of NodeTopologyUpdater interface

func NewMockNodeTopologyUpdater

func NewMockNodeTopologyUpdater(ctrl *gomock.Controller) *MockNodeTopologyUpdater

func (*MockNodeTopologyUpdater) EXPECT

func (_m *MockNodeTopologyUpdater) EXPECT() *_MockNodeTopologyUpdaterRecorder

func (*MockNodeTopologyUpdater) Run

func (_m *MockNodeTopologyUpdater) Run(interval time.Duration, stopChan <-chan struct{})

type NodeTopologyUpdater

type NodeTopologyUpdater interface {
	Run(interval time.Duration, stopChan <-chan struct{})
}

func NewNodeTopologyUpdater

func NewNodeTopologyUpdater(clientset kubecli.KubevirtClient, hinter Hinter, nodeInformer cache.SharedIndexInformer) NodeTopologyUpdater

type TscFrequencyRequirement

type TscFrequencyRequirement struct {
	Type   TscFrequencyRequirementType
	Reason string
}

func GetTscFrequencyRequirement

func GetTscFrequencyRequirement(vmi *k6tv1.VirtualMachineInstance) TscFrequencyRequirement

type TscFrequencyRequirementType

type TscFrequencyRequirementType int

const (
	RequiredForBoot TscFrequencyRequirementType = iota
	RequiredForMigration
	NotRequired
)