Skip to content

feat(worker): unify ModelDeployment router and serving endpoints on port 8000 - #768

Merged
thxCode merged 2 commits into
mainfrom
snakehead
Oct 18, 2026
Merged

thxCode merged 2 commits into
mainfrom
snakehead

Conversation

@thxCode

@thxCode thxCode commented Oct 18, 2026

Copy link
Copy Markdown
Collaborator

What type of PR is this?

/kind enhancement
/area worker

What this PR does / why we need it:

ModelDeployment previously used two different default HTTP ports for inference traffic: role Pods and Service/<md> defaulted to port 8000 (modelDeploymentDefaultPort = 8000), while managed routers (llm-d-router, vllm-router, and sglang-gateway) and Service/<md>-router listened on port 8081 (modelDeploymentRouterHTTPPort = 8081).

This PR moves the managed router HTTP port from 8081 to 8000 so that both unrouted (http://<md>.<ns>.svc:8000) and routed (http://<md>-router.<ns>.svc:8000) deployments expose port 8000 on status.endpoint by default:

  • Task 1 (pkg/worker/controllers/worker, pkg/worker/kvcache/router, pkg/worker/extensionapis/worker): Set modelDeploymentRouterHTTPPort = 8000 and Envoy static listener port_value: 8000 in modelDeploymentRouterEnvoyConfig, and update unit tests across router, controller, and extension API packages.
  • Task 2 (.agents/skills/gpustack-operator-e2e, docs/, specs/): Update end-to-end test cases (case-71.sh, case-91.sh, case-94.sh, case-120.sh, case-121.sh) and walkthroughs (epd.md, external-dp.md) to port 8000, and add the specification in specs/2026-10-18-model-deployment-unify-port-8000.md.

Which issue(s) this PR links to:

Fixes #764

Special notes for your reviewer:

  • make lint agents-shell and make lint docs pass with 0 errors.
  • Unit tests in pkg/worker/kvcache/router, pkg/worker/controllers/worker, and pkg/worker/extensionapis/worker pass under -race.

Does this PR introduce a user-facing change?

Managed `ModelDeployment` routers (`llm-d-router`, `vllm-router`, and `sglang-gateway`) and `Service/<md>-router` now listen on port `8000` instead of `8081`, unifying routed and unrouted `ModelDeployment.status.endpoint` URLs on port `8000`.

- Change modelDeploymentRouterHTTPPort and Envoy listener port_value from 8081 to 8000 so routed and unrouted ModelDeployments both expose port 8000 on status.endpoint.
- Update router, controller, and extension API unit tests to assert port 8000.

Task 1 of model-deployment-unify-port-8000.

Signed-off-by: thxCode <thxcode0824@gmail.com>
…ses and walkthroughs

- Update e2e router cases (71, 91, 94, 120, 121) and walkthroughs (epd, external-dp) from port 8081 to 8000.
- Index the port 8000 unification spec in docs/README.md.

Task 2 of model-deployment-unify-port-8000.

Signed-off-by: thxCode <thxcode0824@gmail.com>
@gpustack-code-review

Copy link
Copy Markdown

✅ OpenCodeReview: Review complete: 0 finding(s) across 5 selected item(s).

@thxCode
thxCode merged commit 7d419d4 into main Oct 18, 2026
11 checks passed
@thxCode
thxCode deleted the snakehead branch October 18, 2026 13:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

enhancement: unify ModelDeployment serving and router endpoints on port 8080

1 participant