Skip to content

docs(epp): stop pinning vLLM on-ramp version #14481

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.

Sign up for GitHub

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
alec-flowers merged 2 commits into from
Sep 10, 2026
Merged

docs(epp): stop pinning vLLM on-ramp version #14481

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2cf7a3a
docs(epp): stop pinning vLLM on-ramp version
JulienDarve Sep 8, 2026
4828b92
docs(epp): require an explicit vLLM image for on-ramp
JulienDarve Sep 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions deploy/inference-gateway/ext-proc/examples/onramp/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ For the user-facing walkthrough, start with

This on-ramp is available for aggregated serving only at this time.

The aggregated on-ramp uses the upstream `vllm/vllm-openai:v0.28.0` image. Replace it with the vLLM
image your platform standardizes on if you need another pinned or internally mirrored image.
Replace `<VLLM_IMAGE>` in `agg.yaml` with the vLLM image your platform uses, including its release
tag or digest. Use a digest for reproducible deployments.
KV-aware selection is provided by the runtime-free
[selection service](../../../../../docs/fern/pages/developer-guide/knowledge-base/modular-components/router/standalone-selection.md),
which the EPP runs **in-process**: the EPP and the selection service are compiled into one binary,
Expand Down
6 changes: 3 additions & 3 deletions deploy/inference-gateway/ext-proc/examples/onramp/agg.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,8 @@
# This secret is required only for gated models; the public model used below
# does not require it.
#
# Replace `dynamo/dynamo-epp:dev` before applying this manifest unless that
# image is already available to the cluster.
# Replace `<VLLM_IMAGE>` and `dynamo/dynamo-epp:dev` with images available to
# the cluster before applying this manifest.
#
# Apply with: kubectl apply -n <ns> -f agg.yaml
# Test:
Expand Down Expand Up @@ -76,7 +76,7 @@ spec:
spec:
containers:
- name: vllm
image: vllm/vllm-openai:v0.28.0
image: <VLLM_IMAGE>
args:
- --model
- Qwen/Qwen3-0.6B
Expand Down
15 changes: 10 additions & 5 deletions docs/fern/pages/kubernetes/kv-aware-routing/vanilla-vllm-onramp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -182,10 +182,13 @@ creates the workload layer in `$NAMESPACE`:
- Two standalone EPP replicas and their gRPC and replica-synchronization Service.
- An `InferencePool` and an `HTTPRoute` that attaches to the cross-namespace Gateway.

Apply the manifest from the repository root using the image you pushed:
Set `VLLM_IMAGE` to the vLLM image your platform uses, including its release tag or digest. Use a
digest for reproducible deployments. Apply the manifest from the repository root using that image
and the EPP image you pushed:

```bash
sed "s#dynamo/dynamo-epp:dev#$EPP_IMAGE#" \
sed -e "s#dynamo/dynamo-epp:dev#${EPP_IMAGE:?Set EPP_IMAGE to the image you pushed}#" \
-e "s#<VLLM_IMAGE>#${VLLM_IMAGE:?Set VLLM_IMAGE to your chosen vLLM image}#" \
deploy/inference-gateway/ext-proc/examples/onramp/agg.yaml |
kubectl apply -n "$NAMESPACE" -f -
```
Expand Down Expand Up @@ -238,14 +241,16 @@ kubectl patch deployment/vllm-qwen -n "$NAMESPACE" --type merge \
Do not use `kubectl label deployment` for this step. That command changes
`Deployment.metadata.labels`, which does not label the worker pods.

Compare a typical existing vLLM container with the changes required by the on-ramp.
Compare a typical existing vLLM container with the changes required by the on-ramp. In both
snippets, replace `<VLLM_IMAGE>` with your existing vLLM image reference, including its release tag
or digest.

**Before — existing vLLM container:**

```yaml
containers:
- name: vllm
image: vllm/vllm-openai:v0.28.0
image: <VLLM_IMAGE>
args:
- --model
- Qwen/Qwen3-0.6B
Expand All @@ -261,7 +266,7 @@ containers:
```yaml
containers:
- name: vllm
image: vllm/vllm-openai:v0.28.0
image: <VLLM_IMAGE>
args:
- --model
- Qwen/Qwen3-0.6B
Expand Down
Loading