types

type AwayNodeType struct {
	// Priority is the priority class priority that the scheduler should use
	// when scheduling "away" jobs of this priority class on the the node type
	// referenced by WellKnownNodeTypeName; it overrides the Priority field of
	// PriorityClass.
	Priority int32 `validate:"gte=0"`
	// WellKnownNodeTypeName is the Name of the WellKnownNodeType in question.
	// Deprecated
	// Use NodeTypes which provides the the same functionality with additional features
	// For now this configuration will still be respected but will be removed in future
	WellKnownNodeTypeName string
	// NodeTypes
	// A list of away type entries that define this away node type
	NodeTypes []AwayTypeEntry
}

type AwayNodeTypeCondition struct {
	// Resource is the Kubernetes resource name, e.g. "cpu", "memory", "nvidia.com/gpu".
	Resource string `validate:"required"`
	// Operator is one of ">", "<", "==".
	Operator AwayNodeTypeConditionOperator `validate:"required"`
	// Value is a Kubernetes resource quantity string, e.g. "1", "4Gi".
	Value resource.Quantity `validate:"required"`
}

type AwayNodeTypeConditionOperator string

type AwayTypeEntry struct {
	// Name references a WellKnownNodeType defined in SchedulingConfig.WellKnownNodeTypes.
	Name string `validate:"required"`
	// Conditions which must be met for this entry to be applied for away scheduling
	// If the conditions are not met, the tolerations for the referenced well known node type will not be added to the job
	Conditions []AwayNodeTypeCondition `validate:"dive"`
}

type PriorityClass struct {
	// Priority controls scheduling order. Higher values get scheduled first and can
	// preempt running jobs with lower priority values (urgency-based preemption).
	Priority int32 `validate:"gte=0"`
	// Preemptible determines if jobs can be evicted to rebalance resources across queues.
	// When false, jobs are protected from fair-share preemption but can still be preempted
	// by higher-priority jobs.
	Preemptible bool
	// Limits resources assigned to jobs of this priority class.
	// Specifically, jobs of this priority class are only scheduled if doing so does not exceed this limit.
	MaximumResourceFractionPerQueue map[string]float64
	// Per-pool override of MaximumResourceFractionPerQueue.
	// If missing for a particular pool, MaximumResourceFractionPerQueue is used instead for that pool.
	MaximumResourceFractionPerQueueByPool map[string]map[string]float64
	// AwayNodeTypes is the set of node types that jobs of this priority class
	// can be scheduled on as "away" jobs (i.e., with reduced priority).
	//
	// The scheduler first tries to schedule jobs of this priority class as
	// "home" jobs, and then tries the elements of this slice in order.
	AwayNodeTypes []AwayNodeType `validate:"dive"`
}