Setup default LocalQueue

Setup default LocalQueue to fullfil a queue label on jobs that submited without queue label.
Feature state alpha since Kueue v0.10

This page describes how to setup default LocalQueue to ensure that all Workloads submitted to a specific namespace are managed by Kueue, even if the kueue.x-k8s.io/queue-name label is not specified explicitly.

Setup default LocalQueue

LocalQueueDefaulting is an Alpha feature that allows the use of a LocalQueue with name default as the default LocalQueue for workloads in the same namespace that do not have the kueue.x-k8s.io/queue-name label. The feature is gated by the LocalQueueDefaulting feature gate, and is disabled by default. To use this feature:

  • Enable the LocalQueueDefaulting feature gate. Refer to the feature gates configuration guide for details.
  • create a LocalQueue with the name default in a namespace.

That’s all! Now, to test the feature, create a Job in the same namespace. Observe that the Job is updated with the kueue.x-k8s.io/queue-name: default label.

Note that workloads created in a different namespace or workloads that already have the kueue.x-k8s.io/queue-name label won’t be modified.