Skip to content

docs: add label and annotation propagation documentation#608

Open
khushiiagrawal wants to merge 2 commits intokserve:mainfrom
khushiiagrawal:docs/feat-607
Open

docs: add label and annotation propagation documentation#608
khushiiagrawal wants to merge 2 commits intokserve:mainfrom
khushiiagrawal:docs/feat-607

Conversation

@khushiiagrawal
Copy link

Fixes #607

Proposed Changes

  • Add new documentation page (docs/model-serving/generative-inference/llmisvc/llmisvc-label-propagation.md) covering the label and annotation propagation feature for LLMInferenceService, merged in feat(llmisvc): enable label/annotation propagation kserve#5009 as requested by @sivanantha321.
  • Add the new page to the sidebar under the LLMInferenceService category in sidebars.ts.
  • Add cross-references to the new page from the LLMInferenceService Overview ("Advanced Topics") and Configuration Guide ("Next Steps").

The documentation covers:

  • Two propagation layers: top-level metadata (prefix-filtered allowlist) vs. spec-level fields (unfiltered)
  • Approved prefix allowlists for annotations (k8s.v1.cni.cncf.io, kueue.x-k8s.io, prometheus.io) and labels (kueue.x-k8s.io)
  • Per-component spec fields: spec.labels/spec.annotations, spec.prefill.labels/spec.prefill.annotations, spec.router.scheduler.labels/spec.router.scheduler.annotations
  • Multi-node (LeaderWorkerSet) propagation to both leader and worker templates
  • Precedence rules and a full propagation summary table
  • Practical examples for Kueue, Multus CNI, Prometheus, and custom platform labels

Signed-off-by: khushiiagrawal <khushisaritaagrawal@gmail.com>
@netlify
Copy link

netlify bot commented Mar 12, 2026

Deploy Preview for elastic-nobel-0aef7a ready!

Name Link
🔨 Latest commit c5f9fc5
🔍 Latest deploy log https://app.netlify.com/projects/elastic-nobel-0aef7a/deploys/69be6ca96eeaaa0008865214
😎 Deploy Preview https://deploy-preview-608--elastic-nobel-0aef7a.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@khushiiagrawal
Copy link
Author

@sivanantha321 could you please take a look. thankyou.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds documentation for LLMInferenceService label/annotation propagation and wires it into the docs navigation so users can discover and apply the feature across deployment modes (single-node, multi-node LWS, disaggregated prefill/decode, and scheduler/EPP).

Changes:

  • Added a new doc page describing label/annotation propagation behavior, prefix allowlists, precedence, and examples.
  • Included the new page in the Docusaurus sidebar under the LLMInferenceService section.
  • Added cross-links to the new page from the LLMInferenceService Overview and Configuration Guide “Next steps”.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
sidebars.ts Registers the new label/annotation propagation doc in the LLMInferenceService sidebar section.
docs/model-serving/generative-inference/llmisvc/llmisvc-overview.md Adds an “Advanced Topics” link pointing to the new propagation doc.
docs/model-serving/generative-inference/llmisvc/llmisvc-label-propagation.md New documentation page describing propagation layers, allowlists, precedence, and examples.
docs/model-serving/generative-inference/llmisvc/llmisvc-configuration.md Adds a “Next steps” link to the new propagation doc.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +88 to +92
| Field | Applies to |
|-------|------------|
| `spec.labels` / `spec.annotations` | Decode (main) workload pod templates. Also serves as the base for prefill pods when `spec.prefill` is set. |
| `spec.prefill.labels` / `spec.prefill.annotations` | Prefill workload pod templates (additive; overrides `spec.labels`/`spec.annotations` for the same key) |
| `spec.router.scheduler.labels` / `spec.router.scheduler.annotations` | Scheduler (EPP) pod template only |
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

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

The spec field paths referenced here (spec.labels/spec.annotations, spec.prefill.labels/spec.prefill.annotations, and spec.router.scheduler.labels/spec.router.scheduler.annotations) don’t appear in the generated CRD API reference for LLMInferenceServiceSpec / WorkloadSpec / SchedulerSpec in docs/reference/crd-api.mdx (those sections currently only list template/worker/prefill and router.scheduler.template). This mismatch can confuse readers and suggests either the doc is ahead of the published CRD schema or the field paths need to be adjusted to match the actual CRD. Please either (a) update/regenerate the CRD reference docs so these fields are discoverable, or (b) clarify the minimum KServe version and/or correct the field paths to what the CRD actually exposes (e.g., via template metadata fields if that’s the supported configuration surface).

Copilot uses AI. Check for mistakes.
…n in LLMInferenceService

Signed-off-by: khushiiagrawal <khushisaritaagrawal@gmail.com>
@khushiiagrawal
Copy link
Author

@Jooho i have addressed the review, could you please take a look once, thanks!

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.

docs: Add documentation for LLMInferenceService label and annotation propagation

2 participants