Skip to content

Conversation

@Blaze-DSP
Copy link
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
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
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
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.

@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 <[email protected]>
@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
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
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
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 <[email protected]>
@Future-Outlier Future-Outlier self-assigned this Jan 12, 2026
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.

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.

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

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants