diff --git a/docs/queues/README.md b/docs/queues/README.md index c795a3702..1b0d116ee 100644 --- a/docs/queues/README.md +++ b/docs/queues/README.md @@ -2,6 +2,8 @@ Scheduling queues are the core resource management primitive in KAI Scheduler, providing hierarchical resource allocation with quota guarantees and priority-based distribution. +Currently only queues that have parent queues can be scheduled to and top level queues cannot be used by jobs. This is a limitation that will be fixed in the future [#621](github.com/NVIDIA/KAI-scheduler/issues/621). + ## Table of Contents - [Queue Attributes](#queue-attributes) - [API Reference](#api-reference) diff --git a/docs/quickstart/README.md b/docs/quickstart/README.md index df9551722..205edb8f2 100644 --- a/docs/quickstart/README.md +++ b/docs/quickstart/README.md @@ -11,6 +11,8 @@ After installing KAI Scheduler, a **two-level queue hierarchy** is automatically * `default-parent-queue` – Top-level (parent) queue. By default, this queue has no reserved resource quotas, allowing governance of resource distribution for its leaf queues. * `default-queue` – Leaf (child) queue under the `default-parent-queue` top-level queue. Workloads should reference this queue. +The expected default queues are in [default-queues.yaml](default-queues.yaml). + No manual queue setup is required. Both queues will exist immediately after installation, allowing you to start submitting workloads right away. To customize scheduling, you can create additional queues or modify existing ones to set quotas, priorities, and hierarchies. diff --git a/docs/quickstart/pods/cpu-only-pod.yaml b/docs/quickstart/pods/cpu-only-pod.yaml index a9a5301a5..84c713ead 100644 --- a/docs/quickstart/pods/cpu-only-pod.yaml +++ b/docs/quickstart/pods/cpu-only-pod.yaml @@ -6,7 +6,7 @@ kind: Pod metadata: name: cpu-only-pod labels: - kai.scheduler/queue: test + kai.scheduler/queue: default-queue spec: schedulerName: kai-scheduler containers: @@ -16,4 +16,4 @@ spec: resources: requests: cpu: 100m - memory: 250M \ No newline at end of file + memory: 250M diff --git a/docs/quickstart/pods/gpu-pod.yaml b/docs/quickstart/pods/gpu-pod.yaml index 37d719b46..67365268e 100644 --- a/docs/quickstart/pods/gpu-pod.yaml +++ b/docs/quickstart/pods/gpu-pod.yaml @@ -6,7 +6,7 @@ kind: Pod metadata: name: gpu-pod labels: - kai.scheduler/queue: test + kai.scheduler/queue: default-queue spec: schedulerName: kai-scheduler containers: @@ -16,4 +16,4 @@ spec: args: ["nvidia-smi; trap 'exit 0' TERM; sleep infinity & wait"] resources: limits: - nvidia.com/gpu: "1" \ No newline at end of file + nvidia.com/gpu: "1"