Skip to content

docs: add runtime compatibility page for ModelPack artifact mounts - #236

Open
lmilbaum wants to merge 1 commit into
modelpack:mainfrom
lmilbaum:feat/issue-233-runtime-compatibility-docs
Open

lmilbaum wants to merge 1 commit into
modelpack:mainfrom
lmilbaum:feat/issue-233-runtime-compatibility-docs

Conversation

@lmilbaum

Copy link
Copy Markdown

Summary

  • Adds docs/runtime-compatibility.md with a runtime compatibility matrix documenting which container runtimes support mounting ModelPack artifacts via Kubernetes image volumes (KEP-4639)
  • Fixes an inaccurate claim in docs/spec.md that listed containerd as a supported runtime for artifact mounts (containerd support is still open: Mount OCI Artifacts containerd/containerd#11381)
  • Links the new page from docs/getting-started.md and docs/spec.md

Fixes #233

Runtime matrix

Runtime Min version Artifact mounts
CRI-O v1.33.0 Yes (raw layers only)
containerd — No (tracked: containerd/containerd#11381)
moby / Docker Engine — No (tracked: moby/moby#49591)
Model CSI Driver v0.1.x Yes (runtime-independent)

How to test

  1. Confirm docs/runtime-compatibility.md exists and renders correctly
  2. Confirm docs/spec.md no longer mentions containerd as a runtime that can mount ModelPack artifacts
  3. Confirm all relative links in the new page resolve (./annotations.md, ./getting-started.md#use-models-in-kubernetes, ./modctl.md)
  4. Run make validate-examples && make test — should pass unchanged

Notes

  • The Kubernetes ~1.35 beta-on-by-default row is noted as approximate; the KEP-4639 link is provided for the authoritative version table
  • Issue Document runtime compatibility for mounting ModelPack artifacts #233 should be exempted from the stale bot (suggested: add an on-hold label, which is already exempted in .github/workflows/stale.yml) and kept open until containerd and moby land artifact mount support

🤖 Generated with Claude Code

- Add docs/runtime-compatibility.md: runtime matrix covering CRI-O (v1.33+, raw layers only),
  containerd (not yet supported, tracked in containerd/containerd#11381),
  moby/Docker (not yet supported, tracked in moby/moby#49591),
  and the Model CSI Driver (runtime-independent path)
- Fix inaccurate claim in docs/spec.md that listed containerd as a supported runtime
- Link to the new page from docs/getting-started.md and docs/spec.md

Fixes modelpack#233

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@lmilbaum
lmilbaum force-pushed the feat/issue-233-runtime-compatibility-docs branch from cdef35e to 0a41833 Compare October 28, 2026 05:38
@lmilbaum
lmilbaum marked this pull request as ready for review October 28, 2026 05:44
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.

Document runtime compatibility for mounting ModelPack artifacts

1 participant