Skip to content

feat: add new --model-server-port to replace --vllm-port#2142

Merged
elevran merged 3 commits into
llm-d:mainfrom
zdtsw:issue_2039_2
Jul 26, 2026
Merged

feat: add new --model-server-port to replace --vllm-port#2142
elevran merged 3 commits into
llm-d:mainfrom
zdtsw:issue_2039_2

Conversation

@zdtsw

@zdtsw zdtsw commented Jul 22, 2026

Copy link
Copy Markdown
Member

What type of PR is this?
/kind feature

What this PR does / why we need it:

  • disagg-sidecar expose vllm specific flag name which should be model server neutral. add --model-server-port to replace --vllm-port which stays as a deprecated alias until final removal.
  • update usage text on --data-parallel-size

Which issue(s) this PR fixes:
ref ##2039

Release note (write NONE if no user-facing change):

The pd-sidecar `--vllm-port` flag is deprecated in favor of the vendor-neutral `--model-server-port` and will be removed in a future release. `--vllm-port` continues to work as an alias meanwhile. The same rename applies to the sidecar YAML configuration key: `vllm-port` -> `model-server-port`.

cc @rahulgurnani

- disagg-sidecar expose vllm specific flag name which should be model
  server neutral. add --model-server-port to replace --vllm-port which
  stays as a deprecated alias until final removal.
- update usage text on --data-parallel-size

Signed-off-by: Wen Zhou <wenzhou@redhat.com>
Copilot AI review requested due to automatic review settings July 22, 2026 15:39
@zdtsw
zdtsw requested review from a team, roytman and shmuelk as code owners July 22, 2026 15:39
@zdtsw
zdtsw requested review from ahg-g and elevran July 22, 2026 15:39
@github-actions github-actions Bot added kind/feature Categorizes issue or PR as related to a new feature. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Jul 22, 2026

Copilot AI left a comment

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.

Pull request overview

This PR makes the pd-sidecar port flag/model configuration vendor-neutral by introducing --model-server-port as the preferred flag and keeping --vllm-port as a deprecated alias, while updating related help text and YAML configuration support.

Changes:

  • Add --model-server-port and migrate existing --vllm-port usage via Complete(), marking --vllm-port deprecated.
  • Extend YAML configuration to accept model-server-port (while continuing to accept vllm-port).
  • Update validation error messages and add tests for the new flag and YAML key.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
pkg/sidecar/proxy/options.go Adds the new flag/YAML key and migration logic; updates DecoderURL computation and validation messaging.
pkg/sidecar/proxy/options_test.go Updates port validation expectations and adds tests for migration/YAML handling of the new key.

Comment on lines +670 to 676
// If both keys may be present, Complete() resolves precedence: modelServerPort wins.
if cfg.ModelServerPort != 0 && !opts.isFlagSet(modelServerPort) {
opts.modelServerPort = strconv.Itoa(cfg.ModelServerPort)
}
if cfg.VLLMPort != 0 && !opts.isFlagSet(vllmPort) {
opts.vllmPort = strconv.Itoa(cfg.VLLMPort)
}
Comment on lines +1160 to +1169
func TestModelServerPortYAML(t *testing.T) {
opts, testPFlagSet := newTestOptions(t)
yaml := "{model-server-port: 8203}"
setFlag(t, testPFlagSet, inlineConfiguration, &yaml)
require.NoError(t, testPFlagSet.Parse(nil))

require.NoError(t, opts.Complete())
require.NoError(t, opts.Validate())
require.Equal(t, "http://localhost:8203", opts.DecoderURL.String())
}

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

updated

@github-actions github-actions Bot added kind/feature Categorizes issue or PR as related to a new feature. and removed kind/feature Categorizes issue or PR as related to a new feature. labels Jul 23, 2026
Comment thread pkg/sidecar/proxy/options.go
Comment thread pkg/sidecar/proxy/options.go Outdated
zdtsw added 2 commits July 24, 2026 10:10
- update test and config which still set to old --vllm-port to new flag

Signed-off-by: Wen Zhou <wenzhou@redhat.com>
- old --vllm-port set as flag should override model-server-port in
  Yaml
- wording fix

Signed-off-by: Wen Zhou <wenzhou@redhat.com>
@github-actions github-actions Bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Jul 24, 2026
@elevran
elevran merged commit c0e3048 into llm-d:main Jul 26, 2026
29 checks passed
elevran pushed a commit that referenced this pull request Jul 26, 2026
Signed-off-by: llm-d-router-release-notes[bot] <287676111+llm-d-router-release-notes[bot]@users.noreply.github.com>
Co-authored-by: llm-d-router-release-notes[bot] <287676111+llm-d-router-release-notes[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/feature Categorizes issue or PR as related to a new feature. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants