Skip to content

Guided Model CSI Driver install mission in KubeStellar Console #30

@clubanderson

Description

@clubanderson

We built a guided install mission for the ModelPack Model CSI Driver inside KubeStellar Console, a standalone Kubernetes dashboard (unrelated to legacy kubestellar/kubestellar, kubeflex, or OCM — zero shared code).

Open the Model CSI Driver install mission

What the mission does

The mission runs against your live cluster via kubeconfig. Each step:

  1. Pre-flight — checks prerequisites (helm ≥3.8 for OCI pulls, writable config.rootDir on nodes, optional registry auth for private model registries)
  2. Commands — walks through writing values-custom.yaml, the OCI helm upgrade --install oci://ghcr.io/modelpack/charts/model-csi-driver --version 0.1.2 --namespace model-csi --create-namespace call, and an inline CSI volume example with driver model.csi.modelpack.org taken directly from your docs/getting-started.md
  3. Validation — after install, queries the cluster to confirm the DaemonSet pods are Ready and the model.csi.modelpack.org CSIDriver object is registered
  4. Troubleshooting — on failure, reads pod logs/events and suggests fixes for common causes (registry auth, rootDir writability, disk pressure on cached model layers)
  5. Rollback — ordered uninstall: delete pods that still mount the CSI volume first, then helm uninstall model-csi-driver, then delete the namespace

Works as read-only documentation too — no cluster connection required to browse.

Architecture

graph LR
    A["KubeStellar Console"] --> B["30+ Dashboards<br/>150+ Monitoring Cards"]
    A --> M["Marketplace<br/>(console-marketplace)"]
    A --> D["AI Mission Explorer"]
    D --> E["console-kb"]
    E --> F["186 Install Missions<br/>67 Solution Missions"]
    A --> C["AI Recommendations"]
    A --> H["kc-agent → Codex, Copilot,<br/>Claude CLI, Kube API, MCP"]
    click A href "https://console.kubestellar.io?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=modelpack-csi-driver" _blank
    click M href "https://github.com/kubestellar/console-marketplace?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=modelpack-csi-driver" _blank
    click E href "https://github.com/kubestellar/console-kb/blob/master/fixes/cncf-install/install-modelpack-csi-driver.json?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=modelpack-csi-driver" _blank
    click F href "https://console.kubestellar.io/missions/install-modelpack-csi-driver?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=modelpack-csi-driver" _blank
    click H href "https://github.com/kubestellar/console/tree/main/cmd/kc-agent?utm_source=github&utm_medium=issue&utm_campaign=cncf_outreach&utm_term=modelpack-csi-driver" _blank
Loading

Install

Local (connects to your current kubeconfig context):

curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/start.sh | bash

With GitHub OAuth:

export GITHUB_CLIENT_ID=<your-client-id>
export GITHUB_CLIENT_SECRET=<your-client-secret>
curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/start.sh | bash

Deploy into a cluster:

curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/deploy.sh | bash

Mission definitions are open source — PRs to improve the Model CSI Driver mission welcome at install-modelpack-csi-driver.json. Feel free to close if not relevant.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions