Kueue

When Kueue is installed, four kinds get dedicated detail tabs: Workload, ClusterQueue, LocalQueue, and ResourceFlavor. There are no mutation actions today; the tabs are read-only and tuned for diagnosing admission decisions and queue health.

Workload

The Workload tab summarizes the queue admission state for a single job.

SectionContents
SpecQueue name, priority class, pod sets (name, replica count, requests).
ConditionsThe Kueue condition set: QuotaReserved, Admitted, PodsReady, Finished, Evicted, Requeued.
AdmissionThe cluster queue the workload was admitted into, plus per-podSet assignments of flavor and topology.
Admission ChecksPer-check state (Pending, Ready, Retry, Rejected) and the message Kueue surfaced.
Requeue StateRequeue count and the next requeue timestamp.
Reclaimable PodsPods that Kueue is willing to reclaim if quota becomes tight.

The conditions section is the primary place to look when a workload is stuck. If Admitted is false, the corresponding condition’s message explains why.

ClusterQueue

SectionContents
PreemptionPreemption policies and class weights.
Fair SharingThe weighted share (Kueue 0.7+).
FlavorsReferenced ResourceFlavors and the resource pools that route to them.
StatusPending and admitted workload counts, plus the standard conditions table.

LocalQueue

Shows the parent ClusterQueue, the configured priority class, pending and admitted workload counts, and the conditions table.

ResourceFlavor

Shows the node labels and taints that pods admitted under this flavor need to tolerate, the Karpenter NodeClass reference when set, and any topology-aware scheduling domains.

A pod held by a Kueue admission gate shows a banner on its Scheduling tab. Buoy finds the controlling Workload and reports the queue, admission status, and a link to the Workload detail view. See scheduling.md.


Edit this page on GitLab