Skip to content

[Doc][KubeRay] Add a doc for scheduler plugins #53846

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jun 19, 2025

Conversation

kevin85421
Copy link
Member

@kevin85421 kevin85421 commented Jun 16, 2025

Why are these changes needed?

Add a doc for scheduler plugins

Related issue number

Checks

  • I've signed off every commit(by using the -s flag, i.e., git commit -s) in this PR.
  • I've run scripts/format.sh to lint the changes in this PR.
  • I've included any doc changes needed for https://docs.ray.io/en/master/.
    • I've added any new APIs to the API Reference. For example, if I added a
      method in Tune, I've added it in doc/source/tune/api/ under the
      corresponding .rst file.
  • I've made sure the tests are passing. Note that there might be a few flaky tests, see the recent failures at https://flakey-tests.ray.io/
  • Testing Strategy
    • Unit tests
    • Release tests
    • This PR is not tested :(

Signed-off-by: kaihsun <kaihsun@anyscale.com>
Copy link
Member

@MortalHappiness MortalHappiness left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doc build failed. You need to add this doc to toctree.


Note that there are two modes for installing the scheduler plugins: **single scheduler mode** or **second scheduler mode**.

For KubeRay v1.4.0, KubeRay only supports the **single scheduler mode**.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Have you already tried both modes and confirmed that it only works with the single scheduler mode?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I haven't tried the second scheduler mode. I am referring to https://scheduler-plugins.sigs.k8s.io/docs/user-guide/installation/:

image

I can give it a try.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It doesn't work with the second scheduler although Step 4 is the same.

I tried to deploy a RayCluster with 1 CPU for the head Pod and 1000 CPUs for the worker Pods. The head Pod will still be scheduled when gang scheduling is enabled.

Signed-off-by: kaihsun <kaihsun@anyscale.com>
Signed-off-by: kaihsun <kaihsun@anyscale.com>
@kevin85421 kevin85421 marked this pull request as ready for review June 16, 2025 17:58
@kevin85421 kevin85421 requested review from pcmoritz and a team as code owners June 16, 2025 17:58
@kevin85421 kevin85421 added the go add ONLY when ready to merge, run all tests label Jun 16, 2025
Copy link
Member

@MortalHappiness MortalHappiness left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved from technical side. Waiting for doc team's approval.

@kevin85421
Copy link
Member Author

cc @dayshah would you mind approving this PR? Thanks!

Copy link
Contributor

@angelinalg angelinalg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just some style nits. Thank you for contributing to docs.

kevin85421 and others added 2 commits June 18, 2025 14:19
Co-authored-by: angelinalg <122562471+angelinalg@users.noreply.github.com>
Signed-off-by: Kai-Hsun Chen <kaihsun@apache.org>
Signed-off-by: kaihsun <kaihsun@anyscale.com>
@kevin85421
Copy link
Member Author

Thanks @MortalHappiness @angelinalg for the review!

@kevin85421
Copy link
Member Author

cc @jjyao @edoakes would you mind merging this PR? Thanks!

@jjyao jjyao merged commit 840fb8a into ray-project:master Jun 19, 2025
5 checks passed
minerharry pushed a commit to minerharry/ray that referenced this pull request Jun 27, 2025
Signed-off-by: kaihsun <kaihsun@anyscale.com>
Signed-off-by: Kai-Hsun Chen <kaihsun@apache.org>
Co-authored-by: angelinalg <122562471+angelinalg@users.noreply.github.com>
elliot-barn pushed a commit that referenced this pull request Jul 2, 2025
Signed-off-by: kaihsun <kaihsun@anyscale.com>
Signed-off-by: Kai-Hsun Chen <kaihsun@apache.org>
Co-authored-by: angelinalg <122562471+angelinalg@users.noreply.github.com>
Signed-off-by: elliot-barn <elliot.barnwell@anyscale.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
go add ONLY when ready to merge, run all tests
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants