Skip to content

Conversation

@win5923
Copy link
Contributor

@win5923 win5923 commented Oct 30, 2025

Description

Starting with KubeRay 1.5.0, KubeRay supports gang scheduling for RayJob custom resources.
Add a example in KubeRay integration with Volcano doc.

Related issues

Related to ray-project/kuberay#3972

Additional information

None.

@win5923 win5923 requested review from a team as code owners October 30, 2025 17:28
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request adds a new documentation section demonstrating how to use Volcano for gang scheduling with RayJob. The example is clear and walks through a practical scenario. I've provided a few suggestions to improve clarity, consistency, and the long-term stability of the documentation, such as using versioned URLs for examples and clarifying the description of the sample YAML file.

First, Create a RayJob

```shell
curl -LO https://raw.githubusercontent.com/ray-project/kuberay/master/ray-operator/config/samples/ray-job.volcano-scheduler-queue.yaml
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

The URL for the sample YAML file points to the master branch. For documentation, it's a best practice to link to a specific version tag (e.g., v1.5.0) instead of a branch. This ensures that the example remains valid and reproducible even if the file on the master branch changes in the future.

Suggested change
curl -LO https://raw.githubusercontent.com/ray-project/kuberay/master/ray-operator/config/samples/ray-job.volcano-scheduler-queue.yaml
curl -LO https://raw.githubusercontent.com/ray-project/kuberay/v1.5.0/ray-operator/config/samples/ray-job.volcano-scheduler-queue.yaml

Copy link
Member

Choose a reason for hiding this comment

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

I think fixed version will be better, cc @win5923

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, changed to use v1.5.0-rc.0.
b58c683

@win5923
Copy link
Contributor Author

win5923 commented Oct 30, 2025

Hi @Future-Outlier and @rueian ,PTAL when you have time. Thanks!

cursor[bot]

This comment was marked as outdated.

Signed-off-by: win5923 <ken89@kimo.com>
@ray-gardener ray-gardener bot added core Issues that should be addressed in Ray Core community-contribution Contributed by the community labels Oct 30, 2025
Copy link
Member

@Future-Outlier Future-Outlier left a comment

Choose a reason for hiding this comment

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

overall LGTM, thank you!!!
@win5923

First, Create a RayJob

```shell
curl -LO https://raw.githubusercontent.com/ray-project/kuberay/master/ray-operator/config/samples/ray-job.volcano-scheduler-queue.yaml
Copy link
Member

Choose a reason for hiding this comment

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

I think fixed version will be better, cc @win5923

Comment on lines 328 to 329
### Step 6: Use Volcano for RayJob gang scheduling

Copy link
Member

Choose a reason for hiding this comment

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

I think it's a little bit weird to use Step 6, instead, can we just use Use Volcano for RayJob gang scheduling?

Image Image

https://anyscale-ray--58320.com.readthedocs.build/en/58320/cluster/kubernetes/k8s-ecosystem/volcano.html#step-6-use-volcano-for-rayjob-gang-scheduling

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Sure, this is better. Fixed in b58c683

Signed-off-by: win5923 <ken89@kimo.com>
@win5923
Copy link
Contributor Author

win5923 commented Oct 31, 2025

Will update Yunikorn's in another PR. thanks for the review!

Copy link
Member

@Future-Outlier Future-Outlier left a comment

Choose a reason for hiding this comment

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

LGTM, cc @jjyao for merge.

@jjyao jjyao added the go add ONLY when ready to merge, run all tests label Oct 31, 2025
@win5923 win5923 changed the title [Docs] Add Volcano RayJob gang scheduling example [Docs][KubeRay] Add Volcano RayJob gang scheduling example Nov 1, 2025
@jjyao jjyao merged commit 91ac4c7 into ray-project:master Nov 2, 2025
7 checks passed
YoussefEssDS pushed a commit to YoussefEssDS/ray that referenced this pull request Nov 8, 2025
landscapepainter pushed a commit to landscapepainter/ray that referenced this pull request Nov 17, 2025
Aydin-ab pushed a commit to Aydin-ab/ray-aydin that referenced this pull request Nov 19, 2025
…ct#58320)

Signed-off-by: win5923 <ken89@kimo.com>
Signed-off-by: Aydin Abiar <aydin@anyscale.com>
SheldonTsen pushed a commit to SheldonTsen/ray that referenced this pull request Dec 1, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-contribution Contributed by the community core Issues that should be addressed in Ray Core 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