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.

Glossary

Admission

The process of admitting a Workload to start (Pods to be created). A Workload is admitted by a ClusterQueue according to the available resources and gets resource flavors assigned for each requested resource.

Sometimes referred to as workload scheduling or job scheduling (not to be confused with pod scheduling).

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.