Skip to content
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

[Docs][Kuberay] Create an example doc for Modin #46345

Merged
merged 1 commit into from
Jul 12, 2024

Conversation

MortalHappiness
Copy link
Member

@MortalHappiness MortalHappiness commented Jun 30, 2024

Why are these changes needed?

See the description in the corresponding issue for details.
Related PR: ray-project/kuberay#2221

Related issue number

Resolves: ray-project/kuberay#2190

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 :(

@MortalHappiness
Copy link
Member Author

@kevin85421 Could you help me review this PR? Thanks.

@kevin85421 kevin85421 self-assigned this Jul 2, 2024

Create a file named `ray-job.modin.yaml` with the following content:

```yaml
Copy link
Member

Choose a reason for hiding this comment

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

Add a YAML KubeRay repository.

Copy link
Member Author

Choose a reason for hiding this comment

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

Done

metadata:
name: ray-job-code-sample
data:
sample_code.py: |
Copy link
Member

Choose a reason for hiding this comment

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

Use a real-world example instead.

Copy link
Member Author

Choose a reason for hiding this comment

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

Done

Copy link
Collaborator

@can-anyscale can-anyscale left a comment

Choose a reason for hiding this comment

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

  • push back to your queue for @kevin85421's feedback
  • do you mind add a screenshot or link to the generated page, thankks

@MortalHappiness
Copy link
Member Author

@can-anyscale PTAL. Thanks.
image


Run the following command to check the output:

```sh
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 ever updated the logs after unwrapping the Modin example from a Ray task?

Copy link
Member Author

Choose a reason for hiding this comment

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

Done

@kevin85421 kevin85421 added the go add ONLY when ready to merge, run all tests label Jul 9, 2024
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.

Some suggestions for style consistency. Please consider installing Vale to check for these corrections. https://docs.ray.io/en/latest/ray-contribute/docs.html#how-to-use-vale

Please also verify the technical accuracy of my suggestion for an introductory sentence for Step 2, proposed line 13.

Thanks for making Ray docs better!!


# Use Modin with Ray on Kubernetes

In this example, you will learn how to run a modified version of the [Using Modin with the NYC Taxi Dataset](https://github.com/modin-project/modin/blob/4e7afa7ea59c7a160ed504f39652ff23b4d49be3/examples/jupyter/Modin_Taxi.ipynb) example from the Modin official repository using RayJob on Kubernetes.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
In this example, you will learn how to run a modified version of the [Using Modin with the NYC Taxi Dataset](https://github.com/modin-project/modin/blob/4e7afa7ea59c7a160ed504f39652ff23b4d49be3/examples/jupyter/Modin_Taxi.ipynb) example from the Modin official repository using RayJob on Kubernetes.
This example runs a modified version of the [Using Modin with the NYC Taxi Dataset](https://github.com/modin-project/modin/blob/4e7afa7ea59c7a160ed504f39652ff23b4d49be3/examples/jupyter/Modin_Taxi.ipynb) example from the Modin official repository using RayJob on Kubernetes.


In this example, you will learn how to run a modified version of the [Using Modin with the NYC Taxi Dataset](https://github.com/modin-project/modin/blob/4e7afa7ea59c7a160ed504f39652ff23b4d49be3/examples/jupyter/Modin_Taxi.ipynb) example from the Modin official repository using RayJob on Kubernetes.

## Step 1: Install Kuberay operator
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
## Step 1: Install Kuberay operator
## Step 1: Install KubeRay operator


## Step 1: Install Kuberay operator

Follow the steps 1 and 2 from the [RayCluster Quick Start](kuberay-raycluster-quickstart) guide to install Kuberay operator.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Follow the steps 1 and 2 from the [RayCluster Quick Start](kuberay-raycluster-quickstart) guide to install Kuberay operator.
Follow steps 1 and 2 from [RayCluster Quickstart](kuberay-raycluster-quickstart) to install KubeRay operator.

Follow the steps 1 and 2 from the [RayCluster Quick Start](kuberay-raycluster-quickstart) guide to install Kuberay operator.

## Step 2: Run the Modin example with RayJob

Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Create a RayJob that runs the Modin example using the following command:

Copy link
Member Author

Choose a reason for hiding this comment

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

@angelinalg Thank you! I've pushed updates according to your suggestions.

@jjyao jjyao requested a review from can-anyscale July 12, 2024 05:08
@jjyao jjyao merged commit dbee34e into ray-project:master Jul 12, 2024
5 checks passed
Catch-Bull pushed a commit to Catch-Bull/ray that referenced this pull request Jul 15, 2024
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.

[Feature] Create an example doc for Modin
5 participants