Chris Farhood
e2512ec500
- Remove PROMPT.md (AI scaffolding artifact) - Add .claude/settings* to .gitignore - Commit .mcp.json (MCP server config) - Fix ArtifactHub URLs (headlamp/tns-csi path) - Fix tarball name (tns-csi-VERSION.tar.gz) in all install docs - Update version URLs from v0.1.0/v0.2.0 to v0.2.4 - Update test count from 67 to 159 across 12 files - Update Node.js version from 20 to 22 - Add CHANGELOG entry for v0.2.4 - Update testing.md with full test file inventory and CI description Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
TNS-CSI Plugin Documentation
Welcome to the Headlamp TNS-CSI Plugin documentation.
Quick Links
- Quick Start — Get up and running in 5 minutes
- Installation Guide — All installation methods
- Troubleshooting — Common issues and fixes
Documentation Index
Getting Started
| Guide | Description |
|---|---|
| Quick Start | Fastest path to a working installation |
| Installation | Plugin Manager, manual tarball, build from source |
| Prerequisites | Headlamp version, tns-csi driver, RBAC |
User Guide
| Guide | Description |
|---|---|
| Overview Dashboard | Driver health, storage summary, protocol distribution |
| Storage Classes | StorageClass list and detail panel |
| Volumes | PersistentVolume list and detail panel |
| Snapshots | VolumeSnapshot list and CRD requirements |
| Metrics | Prometheus metrics display |
| Benchmark | kbench interactive storage benchmarking |
| PVC Detail Injection | TNS-CSI section in PVC detail views |
| RBAC Permissions | Required permissions per feature |
Architecture
| Guide | Description |
|---|---|
| Overview | System architecture, data flow, component hierarchy |
| Data Flow | How data moves from K8s API to the UI |
| Design Decisions | Key architectural choices and rationale |
Deployment
| Guide | Description |
|---|---|
| Helm | Deploy with Helm (recommended) |
| Production Checklist | Security and reliability checklist |
Troubleshooting
| Guide | Description |
|---|---|
| Common Issues | Quick diagnosis table |
| RBAC Issues | 403 errors, missing permissions |
| Driver Detection | Driver not installed, wrong provisioner |
| Metrics Issues | Empty metrics page, unreachable controller |
| Benchmark Issues | Benchmark fails to start or complete |
Development
| Guide | Description |
|---|---|
| Development Setup | Clone, install, run dev server |
| Testing | Unit tests, mocking headlamp APIs |
| Release Process | How releases are cut and published |