[kevin85421]

What type of PR is this?

/kind bug
/area integrations

What this PR does / why we need it?

Cherry-pick of #16884 onto release-0.20, requested in #16884 (comment).

Respect KubeRay worker group minReplicas and maxReplicas when deriving PodSet counts, including multi-host replicas. When an autoscaler allocation timeout reduces replicas below minReplicas, KubeRay still creates the minimum number of workers; accounting for that minimum prevents the extra workers from remaining scheduling-gated.

Useful notes for your reviewer

The original fix applies without conflicts. The partial replica scale-up fixture updates are included.

Validation:

• Passed: go test ./pkg/controller/jobs/raycluster ./pkg/controller/jobs/rayjob ./pkg/controller/jobs/rayservice.
• Passed: make ci-lint.
• Passed: partial replica scale-up integration suite with race detection (10 specs).
• Passed: GOTOOLCHAIN=go1.27.0 make verify (including API lint; rebuilt the API linter with Go 1.27 to match this branch).

AI assistance: OpenAI Codex prepared the cherry-pick, resolved branch compatibility conflicts where needed, ran validation, and prepared this PR.

Release note

RayCluster: Fixed a bug where worker PodSet counts could fall below KubeRay’s minimum replica count, leaving workers scheduling-gated when capacity became available. Kueue now respects worker replica bounds when calculating PodSet counts.

[netlify]

✅ Deploy Preview for kubernetes-sigs-kueue ready!

Name	Link
🔨 Latest commit	a3847cd
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-sigs-kueue/deploys/6ad2631206849e348fc96af2
😎 Deploy Preview	https://deploy-preview-17366--kubernetes-sigs-kueue.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review: 1

• main

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Repository: kubernetes-sigs/kueue/.coderabbit.yaml
• Review profile: CHILL
• Plan: Advanced
• Run ID: 5c0edcd4-3547-42aa-84e1-a44dfedb1b1a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

_{Comment @coderabbitai help to get the list of available commands.}

[mimowo]

/lgtm
/approve

[kubernetes-prow]

LGTM label has been added.

Details

Git tree hash: d764b97200ce595b2e7f708fa8046019ec6f23bf

[kubernetes-prow]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kevin85421, mimowo

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [mimowo]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[mbobrovskyi]

/set-release-note
RayCluster: Fixed a bug where worker PodSet counts could fall below KubeRay’s minimum replica count, leaving workers scheduling-gated when capacity became available. Kueue now respects worker replica bounds when calculating PodSet counts.

[github-actions]

✅ The release note was updated.