Skip to content

Guided Model CSI Driver install mission in KubeStellar Console #30

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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions