Concepts

This section of the documentation helps you learn about the components, APIs and abstractions that Kueue uses to represent your cluster and workloads.

APIs

Resource Flavor

An object that you can define to describe what resources are available in a cluster. Typically, a ResourceFlavor is associated with the characteristics of a group of Nodes. It could distinguish among different characteristics of resources such as availability, pricing, architecture, models, etc.

Cluster Queue

A cluster-scoped resource that governs a pool of resources, defining usage limits and fair sharing rules.

Local Queue

A namespaced resource that groups closely related workloads belonging to a single tenant.

Workload

An application that will run to completion. It is the unit of admission in Kueue. Sometimes referred to as job.

Workload Priority Class

WorkloadPriorityClass defines a priority class for a workload, independently from pod priority.
This priority value from a WorkloadPriorityClass is only used for managing the queueing and preemption of Workloads.

Admission Check

A mechanism allowing internal or external components to influence the timing of workloads admission.

Glossary

Quota Reservation

Sometimes referred to as workload scheduling or job scheduling (not to be confused with pod scheduling). Is the process during which the kueue scheduler locks the resources needed by a workload within the targeted ClusterQueues ResourceGroups

Admission

The process of admitting a Workload to start (Pods to be created). A Workload is admitted when it has a Quota Reservation and all its AdmissionCheckStates are Ready.

Cohort

A group of ClusterQueues that can borrow unused quota from each other.

Queueing

The time between a Workload is created until it is admitted by a ClusterQueue. Typically, the Workload will compete with other Workloads for available quota based on the fair sharing rules of the ClusterQueue.