Skip to content

Commit bef2cce

Browse files
committed
Review
Signed-off-by: Pannaga Rao Bhoja Ramamanohara
1 parent 592257b commit bef2cce

File tree

1 file changed

+4
-7
lines changed

1 file changed

+4
-7
lines changed

site/content/en/docs/tasks/manage/enforce_job_management/opt_in_namespace_management.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Opt-in Namespace Management"
33
date: 2025-11-25
44
weight: 15
55
description: >
6-
Configure Kueue to only manage workloads in explicitly labeled namespaces using the ManagedJobsNamespaceSelectorAlwaysRespected feature gate.
6+
Configure Kueue to only manage workloads in explicitly labeled namespaces.
77
---
88

99
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.
@@ -19,7 +19,7 @@ Opt-in namespace management allows cluster administrators to enforce strict quot
1919

2020
- **Prevents quota bypass**: Users cannot bypass Kueue's quota system by manually adding `queue-name` labels to workloads in unmanaged namespaces. Only workloads in opted-in namespaces are ever reconciled by Kueue, regardless of how they are labeled.
2121
- **Explicit control**: Cluster administrators have full control over which namespaces are subject to Kueue management by simply labeling namespaces.
22-
- **Consistent behavior**: This brings `batch/v1/Job` integration into alignment with `Pod`, `Deployment`, and `StatefulSet` integrations, which already enforce namespace-based filtering.
22+
- **Consistent behavior**: This brings `batch/v1.Job` integration into alignment with `Pod`, `Deployment`, and `StatefulSet` integrations, which already enforce namespace-based filtering.
2323

2424
## Configuration
2525

@@ -47,8 +47,6 @@ managedJobsNamespaceSelector:
4747
managed-by-kueue: "true"
4848
```
4949
50-
**Note**: When the `ManagedJobsNamespaceSelectorAlwaysRespected` feature gate is enabled, only namespaces that match the selector will be reconciled. Namespaces without the required labels will not be managed by Kueue, regardless of whether workloads in those namespaces have a `queue-name` label.
51-
5250
### Step 3: Enable the Feature Gate
5351
5452
Enable the `ManagedJobsNamespaceSelectorAlwaysRespected` feature gate in your Kueue manager configuration. See [Feature Gate Details](#feature-gate-details) for configuration instructions.
@@ -59,8 +57,7 @@ The `ManagedJobsNamespaceSelectorAlwaysRespected` feature gate controls whether
5957

6058
### Feature Gate Status
6159

62-
- **Alpha**: v0.13
63-
- **Beta**: v0.15
60+
The `ManagedJobsNamespaceSelectorAlwaysRespected` feature gate was introduced as **Alpha** in Kueue v0.13 and graduated to **Beta** in v0.15.
6461

6562
### Enabling the Feature Gate
6663

@@ -75,7 +72,7 @@ metadata:
7572
data:
7673
controller_manager_config.yaml: |
7774
apiVersion: config.kueue.x-k8s.io/v1beta1
78-
kind: ControllerManagerConfig
75+
kind: Configuration
7976
featureGates:
8077
ManagedJobsNamespaceSelectorAlwaysRespected: true
8178
```

0 commit comments

Comments
 (0)