Chris Farhood
9612e8c2c1
The volume name was 'rook-plugin' but the ConfigMap is 'headlamp-kube-vip-plugin', causing mount failures. Align both volumeMounts[*].name and volumes[*].name to 'headlamp-kube-vip-plugin'.
headlamp-kube-vip-plugin
A Headlamp plugin providing visibility into kube-vip virtual IP and load balancer deployments.
Features
- Overview Dashboard — Deployment status, VIP mode (ARP/BGP), leader election, cluster summary
- Services — LoadBalancer services with VIP assignments, kube-vip annotations, egress status
- Nodes — Cluster nodes with kube-vip pod status, leader designation, VIP labels
- Configuration — DaemonSet config, IP address pools, leader election leases
- Service Detail Integration — kube-vip details injected into native Headlamp Service detail views
Installation
Search for kube-vip in the Headlamp Plugin Manager (Settings → Plugins → Catalog).
Requirements
- Headlamp >= v0.26
- kube-vip deployed in
kube-system(DaemonSet or static pod) - Optional: kube-vip-cloud-provider for IP pool management
RBAC
This plugin is read-only and requires the following permissions:
| Resource | API Group | Verbs |
|---|---|---|
| services | v1 | list, get, watch |
| nodes | v1 | list, get, watch |
| pods | v1 | list, get, watch |
| daemonsets | apps/v1 | get |
| leases | coordination.k8s.io | list, get, watch |
| configmaps | v1 | get |
Architecture
src/
├── index.tsx # Plugin entry point
├── api/
│ ├── k8s.ts # Types and helper functions
│ └── KubeVipDataContext.tsx # React context provider
└── components/
├── OverviewPage.tsx # Dashboard
├── ServicesPage.tsx # LoadBalancer services
├── NodesPage.tsx # Cluster nodes
├── ConfigPage.tsx # Configuration & IP pools
└── ServiceDetailSection.tsx # Injected into Service detail view
Development
npm install
npm start # dev server
npm test # run tests
npm run tsc # type check
npm run lint # ESLint
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| "kube-vip Not Detected" | No kube-vip pods in kube-system | Install kube-vip per https://kube-vip.io/docs/installation/ |
| No IP pools shown | kubevip ConfigMap not found | Install kube-vip-cloud-provider |
| Services show "Pending" VIP | No IP pool configured or pool exhausted | Add IP ranges to kubevip ConfigMap |
| Leader shows "—" | No kube-vip leases found | Verify leader election is enabled (vip_leaderelection=true) |
Contributing
See CONTRIBUTING.md for development guidelines.
License
Apache License 2.0. See LICENSE for details.