Skip to content

Title: Add documentation for custom dependencies in RayService and LMCache+Mooncake on Kubernetes#60035

Closed
Blaze-DSP wants to merge 3 commits intoray-project:masterfrom
Blaze-DSP:feat/extra-dependency
Closed

Title: Add documentation for custom dependencies in RayService and LMCache+Mooncake on Kubernetes#60035
Blaze-DSP wants to merge 3 commits intoray-project:masterfrom
Blaze-DSP:feat/extra-dependency

Conversation

@Blaze-DSP
Copy link
Copy Markdown
Contributor

Description

Add documentation for installing custom dependencies in RayService deployments:

  • rayservice.md: Add "Add custom dependencies" section explaining:
    • Shared dependencies via args (system packages + Python packages for all apps)
    • Application-specific dependencies via runtime_env
  • rayserve-llm-example.md: Add section linking to custom dependencies guide and KV cache offloading
  • kv-cache-offloading.md: Add "Deploy on Kubernetes with LMCache and Mooncake" section covering:
    • System package installation for Mooncake
    • LMCache + Mooncake pip packages via runtime_env
    • kv_transfer_config setup
    • Example lmcache-config.yaml for Mooncake backend
  • handling-dependencies.md: Add Kubernetes cross-reference

@Blaze-DSP Blaze-DSP requested review from a team as code owners January 11, 2026 08:24
@Blaze-DSP Blaze-DSP force-pushed the feat/extra-dependency branch from 9e86c70 to 92cb1d8 Compare January 11, 2026 08:26
Copy link
Copy Markdown
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 valuable documentation for installing custom dependencies in RayService deployments on Kubernetes. The new sections in rayservice.md, rayserve-llm-example.md, and kv-cache-offloading.md are clear and provide useful examples for users looking to manage dependencies with args and runtime_env, including a detailed guide for LMCache and Mooncake. The cross-references in handling-dependencies.md are also a good addition. My main feedback is regarding a broken URL in the curl examples, which should be fixed to ensure users can follow the guides successfully.

Download a basic example:

```sh
curl -o ray-serve.extra-dependency.yaml https://raw.githubusercontent.com/ray-project/kuberay/master/ray-operator/config/samples/ray-serve.extra-dependency.yaml
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

The URL in this curl command points to a file that doesn't seem to exist in the master branch of the ray-project/kuberay repository. This will cause the example command to fail for users. Please verify the URL and update it to a valid location.

Download a complete example combining both approaches:

```sh
curl -o ray-serve.extra-dependency.yaml https://raw.githubusercontent.com/ray-project/kuberay/master/ray-operator/config/samples/ray-serve.extra-dependency.yaml
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

The URL in this curl command points to a file that doesn't seem to exist in the master branch of the ray-project/kuberay repository. This will cause the example command to fail for users. Please verify the URL and update it to a valid location.

Signed-off-by: DPatel_7 <dpatel@gocommotion.com>
@Blaze-DSP Blaze-DSP force-pushed the feat/extra-dependency branch from 92cb1d8 to fa2bbf5 Compare January 11, 2026 08:29
Signed-off-by: DPatel_7 <dpatel@gocommotion.com>
@ray-gardener ray-gardener bot added serve Ray Serve Related Issue docs An issue or change related to documentation community-contribution Contributed by the community labels Jan 11, 2026
Copy link
Copy Markdown
Contributor

@kouroshHakha kouroshHakha left a comment

Choose a reason for hiding this comment

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

overall looks good. Let's make sure the full yaml service lands on kuberay repo on git and then we can cross-ref it here.

Download a basic example:

```sh
curl -o ray-serve.extra-dependency.yaml https://raw.githubusercontent.com/ray-project/kuberay/master/ray-operator/config/samples/ray-serve.extra-dependency.yaml
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

is there a pr for this?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Signed-off-by: DPatel_7 <dpatel@gocommotion.com>
@Future-Outlier Future-Outlier self-assigned this Jan 12, 2026
Copy link
Copy Markdown
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.

Copy link
Copy Markdown
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.

we should build a custom image instead, since this might cause other potential problem like here
ray-project/kuberay#4362 (comment)
cc @rueian

@github-actions
Copy link
Copy Markdown

This pull request has been automatically marked as stale because it has not had
any activity for 14 days. It will be closed in another 14 days if no further activity occurs.
Thank you for your contributions.

You can always ask for help on our discussion forum or Ray's public slack channel.

If you'd like to keep this open, just leave any comment, and the stale label will be removed.

@github-actions github-actions bot added the stale The issue is stale. It will be closed within 7 days unless there are further conversation label Jan 28, 2026
@github-actions
Copy link
Copy Markdown

This pull request has been automatically closed because there has been no more activity in the 14 days
since being marked stale.

Please feel free to reopen or open a new pull request if you'd still like this to be addressed.

Again, you can always ask for help on our discussion forum or Ray's public slack channel.

Thanks again for your contribution!

@github-actions github-actions bot closed this Feb 11, 2026
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 docs An issue or change related to documentation serve Ray Serve Related Issue stale The issue is stale. It will be closed within 7 days unless there are further conversation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants