Skip to content

docs: document storageContainerName for explicit ClusterStorageContainer selection - #693

Open
RunlinXiao wants to merge 1 commit into
kserve:mainfrom
RunlinXiao:docs-storage-container-name
Open

docs: document storageContainerName for explicit ClusterStorageContainer selection#693
RunlinXiao wants to merge 1 commit into
kserve:mainfrom
RunlinXiao:docs-storage-container-name

Conversation

@RunlinXiao

@RunlinXiao RunlinXiao commented Jun 11, 2026

Copy link
Copy Markdown

Summary

Documents the new spec.predictor.storageContainerName field introduced in kserve/kserve#5314 (fixes kserve/kserve#5299), which allows users to explicitly select a ClusterStorageContainer instead of relying on URI-based auto-matching when multiple CSCs support the same storage URI format.

Proposed Changes

  • docs/model-serving/storage/storage-containers/storage-containers.md
    • Added a new "Explicitly Selecting a Storage Container" section documenting spec.predictor.storageContainerName, with an example that selects the hf-hub ClusterStorageContainer (defined earlier on the page) over the default one when both support hf://.
    • Documented the eligibility requirements for the referenced CSC (must exist, not be disabled, have workloadType: initContainer, and support the model's storageUri) and that there is no fallback to auto-matching when the field is set.
    • Added a note that the field is predictor-only: explainers and transformers always use URI-based auto-matching, and LLMInferenceService does not support it yet.
    • Updated the existing multiple-match warning to point to the new field instead of advising that each URI format be supported by only one CSC.
  • docs/reference/crd-api.mdx
    • Regenerated from kserve master via make gen-crd-api-docs (NOTES: some generation are not related to the storageContainerName, please let me know if we wanna get them removed)

Changes are made only to the docs/ ("next") version since the feature ships in the next KServe release; no cherry-pick to 0.18 is needed. Verified with a full docusaurus build — no new broken-anchor warnings introduced by these changes.

…ner selection

  Documents the new spec.predictor.storageContainerName field added in
  kserve/kserve#5314, and regenerates the CRD API reference from master.

Signed-off-by: Runlin Xiao <rxiao13@asu.edu>
@netlify

netlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Deploy Preview for elastic-nobel-0aef7a ready!

Name Link
🔨 Latest commit 6b62539
🔍 Latest deploy log https://app.netlify.com/projects/elastic-nobel-0aef7a/deploys/6a2a4c4e3ac02a0008797ccc
😎 Deploy Preview https://deploy-preview-693--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.

Comment thread docs/reference/crd-api.mdx
@spolti
spolti requested a review from pierDipi June 18, 2026 14:12
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.

ClusterStorageContainer is completely ignored

2 participants