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 acd3ecdd [SPARK-59932] Document Kueue v0.20.0+ as the recommended
version
acd3ecdd is described below
commit acd3ecddf3885e905684cacfa80a5b6b1576e834
Author: Dongjoon Hyun <[email protected]>
AuthorDate: Fri Oct 2 00:13:49 2026 -0700
[SPARK-59932] Document Kueue v0.20.0+ as the recommended version
### What changes were proposed in this pull request?
This PR aims to document Kueue
[v0.20.0](https://github.com/kubernetes-sigs/kueue/releases/tag/v0.20.0)
(2026-09-30) or newer as the recommended Kueue version in the `Compatibility`
section of `docs/operations.md`.
### Why are the changes needed?
The Kueue integration is new in 1.1.0, and the documentation does not
mention which Kueue versions it works with.
- The operator uses only the `kueue.x-k8s.io/v1beta2` API, which Kueue has
served since
[v0.15.0](https://github.com/kubernetes-sigs/kueue/releases/tag/v0.15.0)
(2025-11-28). So the operator does not depend on any feature that only v0.20.0
has.
- However, the documentation of the Kueue integration assumes the behavior
of recent Kueue versions, e.g., `waitForPodsReady` enabled by default since
v0.19. Also, the CI runs the Kueue E2E tests against v0.20.0 only (SPARK-59930).
So this PR recommends v0.20.0 or newer, like the existing recommendation
for K8s 1.35, instead of making it a hard requirement.
### 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.
### Was this patch authored or co-authored using generative AI tooling?
Generated-by: Claude Opus 5.5
Closes #921 from dongjoon-hyun/SPARK-59932.
Authored-by: Dongjoon Hyun <[email protected]>
Signed-off-by: Dongjoon Hyun <[email protected]>
---
docs/operations.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/operations.md b/docs/operations.md
index 97eea019..581ef706 100644
--- a/docs/operations.md
+++ b/docs/operations.md
@@ -26,6 +26,7 @@ under the License.
- k8s version >= 1.35 is recommended. Operator attempts to be as API
compatible as possible, but
patch support will not be performed on k8s versions that reached EOL.
- Spark versions 4.0 or above.
+- Kueue version >= 0.20.0 is recommended when the Kueue integration is enabled.
## Optional Prerequisites
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
