kserve/storage-initializer 是 KServe 推理栈的 initContainer 实现，根据 storageUri 将模型文件下载到 mountPath，主预测容器随后只读挂载同一卷启动。与自定义 init 脚本相比与 InferenceService CRD 约定一致，支持多种对象存储协议。设计为短生命周期 init 步骤，不适合独立 Deployment 长期运行；Kubernetes 中由 KServe 控制器自动注入，单独 docker run 仅用于调试下载逻辑。

快速启动

docker run --rm \
  -v $(pwd)/model:/mnt/models \
  -e STORAGE_URI=s3://my-bucket/model/v1 \
  docker.io/kserve/storage-initializer:latest

推荐实践

docker run --rm \
  -v /data/model-cache:/mnt/models \
  -e STORAGE_URI=gs://models/resnet50 \
  -e AWS_ACCESS_KEY_ID=xxx -e AWS_SECRET_ACCESS_KEY=xxx \
  docker.io/kserve/storage-initializer:v0.13.0

核心参数说明

• -e STORAGE_URI — 模型源 s3://、gs:// 或 https:// 地址
• -v /data/model-cache:/mnt/models — 本地下载目标卷
• -e AWS_* — S3 兼容存储凭证
• --rm — 初始化完成即退出
• 固定 tag — 与 KServe 控制器版本匹配
• 定位 — InferenceService initContainer，非独立服务