Enforce Kueue Management of Workloads on Kueue

Setup default LocalQueue

Thu, 12 Dec 2024 00:00:00 +0000

Feature state stable since Kueue v0.17

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 a 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.

Setup a Job Admission Policy

Fri, 28 Jun 2024 00:00:00 +0000

This page shows how you can set up for Kueue a Job Admission Policy using the Kubernetes Validating Admission Policy, based on the Common Expression Language (CEL).

Before you begin

Ensure the following conditions are met:

A Kubernetes cluster is running.
The ValidatingAdmissionPolicy feature gate is enabled. In Kubernetes 1.30 or newer, the feature gate is enabled by default.
The kubectl command-line tool can communicate with your cluster.
Kueue is installed.

Enforce Queue Name - Example

The example below shows you how to set up a Job Admission Policy to reject early all Job or JobSets without the queue-name if sent to a namespace labeled as a kueue-managed namespace.

Setup manageJobsWithoutQueueName

Fri, 28 Jun 2024 00:00:00 +0000

This page describes how to configure Kueue to ensure that all Workloads submitted in namespaces intended for use by batch users will be managed by Kueue even if they lack a kueue.x-k8s.io/queue-name label.

Before you begin

Learn how to install Kueue with a custom manager configuration.

Opt-in Namespace Management

Tue, 25 Nov 2025 00:00:00 +0000

This page describes how to configure Kueue to enforce opt-in namespace management, ensuring that only workloads in explicitly labeled namespaces are reconciled by Kueue.

Before you begin

Learn how to install Kueue with a custom manager configuration.
Understand how to configure manageJobsWithoutQueueName.
Learn how to change the feature gates configuration.

Why Use Opt-in Namespace Management?

Opt-in namespace management allows cluster administrators to enforce strict quota controls by ensuring that Kueue only manages workloads in explicitly designated namespaces. This provides several key benefits: