This is an automated email from the ASF dual-hosted git repository.
dongjoon-hyun pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/spark-kubernetes-operator.git
The following commit(s) were added to refs/heads/main by this push:
new f1897fc1 [SPARK-60116] Document Kueue default `LocalQueue` as not
supported
f1897fc1 is described below
commit f1897fc16abf8024ee857f83c8fc5e565efdada5
Author: Dongjoon Hyun <[email protected]>
AuthorDate: Sat Oct 10 08:08:46 2026 +0100
[SPARK-60116] Document Kueue default `LocalQueue` as not supported
### What changes were proposed in this pull request?
This PR aims to add a row to the Kueue feature support table of
`docs/spark_custom_resources.md` to document that the default `LocalQueue` of
Kueue is not supported.
### Why are the changes needed?
For the built-in integrations, Kueue sets the `kueue.x-k8s.io/queue-name`
label of a job without the label to `default` if its namespace has a
`LocalQueue` named `default`. This does not apply to `SparkApplication` and
`SparkCluster`, since the Kueue webhooks do not cover the `spark.apache.org`
group. So the label should be set explicitly, e.g. `kueue.x-k8s.io/queue-name:
default`.
### Does this PR introduce _any_ user-facing change?
No. This is a documentation-only change for an unreleased feature.
### How was this patch tested?
Manual review against the code and Kueue v0.20.0.
### Was this patch authored or co-authored using generative AI tooling?
Generated-by: Claude Opus 5.5
Closes #961 from dongjoon-hyun/SPARK-60116.
Authored-by: Dongjoon Hyun <[email protected]>
Signed-off-by: Dongjoon Hyun <[email protected]>
---
docs/spark_custom_resources.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/spark_custom_resources.md b/docs/spark_custom_resources.md
index f2771ac1..48ff5900 100644
--- a/docs/spark_custom_resources.md
+++ b/docs/spark_custom_resources.md
@@ -678,6 +678,7 @@ relates it to the reconciliation.
| MultiKueue |
Not supported | `SparkApplication` and `SparkCluster` have no
`spec.managedBy` field, which MultiKueue needs to run them on a worker cluster.
|
| Elastic workloads (`Workload` slices) |
Not supported | A resource has one `Workload` whose pod set counts are
fixed.
|
| `manageJobsWithoutQueueName` and `managedJobsNamespaceSelector` |
Not supported | Kueue does not manage the Spark custom resources itself,
so a resource without the `kueue.x-k8s.io/queue-name` label is not queued and
starts right away.
|
+| Defaulting the queue name to the `default` `LocalQueue` of the namespace |
Not supported | A resource without the `kueue.x-k8s.io/queue-name` label
is not queued even if its namespace has a `LocalQueue` named `default`, so set
the label explicitly, e.g. `kueue.x-k8s.io/queue-name: default`.
|
| Dynamic allocation (`spark.dynamicAllocation.enabled`) |
Not supported | Such a `SparkApplication` fails with `SchedulingFailure`
instead of being queued.
|
| `SparkCluster` with `minWorkers < maxWorkers` |
Not supported | Such a `SparkCluster` fails with `SchedulingFailure`
instead of being queued.
|
| Pod template files (`spark.kubernetes.{driver,executor}.podTemplateFile`) |
Not supported | A `SparkApplication` whose pod template is set only in
such a file fails with `SchedulingFailure`, so set it in the
[spec](#pod-template-support) instead.
|
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
