DevContainer User
3b9d007e8b
Headlamp plugin providing visibility into kube-vip virtual IP and load balancer deployments. Features: - Overview dashboard with deployment status, VIP mode, leader election - Services page with LoadBalancer VIP assignments and detail panels - Nodes page showing kube-vip pod status and leader designation - Configuration page with DaemonSet config, IP pools, leases - Service detail section injected into native Headlamp Service views Read-only plugin — no cluster write operations. Uses standard K8s resources (no CRDs): Services, Nodes, Pods, DaemonSets, Leases, ConfigMaps with kube-vip.io/* annotations. 74 tests across 7 test files. All tsc/lint/format/test checks pass. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
103 lines
3.4 KiB
Markdown
103 lines
3.4 KiB
Markdown
# headlamp-kube-vip-plugin
|
|
|
|
[](https://github.com/privilegedescalation/headlamp-kube-vip-plugin/actions/workflows/ci.yml)
|
|
[](https://opensource.org/licenses/Apache-2.0)
|
|
|
|
A [Headlamp](https://headlamp.dev/) plugin providing visibility into [kube-vip](https://kube-vip.io/) 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
|
|
|
|
### Plugin Manager (Headlamp UI)
|
|
|
|
Search for `kube-vip` in the Headlamp Plugin Manager.
|
|
|
|
### Manual
|
|
|
|
```bash
|
|
# Download the latest release tarball
|
|
curl -LO https://github.com/privilegedescalation/headlamp-kube-vip-plugin/releases/latest/download/kube-vip-*.tar.gz
|
|
|
|
# Extract to Headlamp plugins directory
|
|
mkdir -p ~/.config/Headlamp/plugins
|
|
tar -xzf kube-vip-*.tar.gz -C ~/.config/Headlamp/plugins/
|
|
```
|
|
|
|
### From Source
|
|
|
|
```bash
|
|
git clone https://github.com/privilegedescalation/headlamp-kube-vip-plugin.git
|
|
cd headlamp-kube-vip-plugin
|
|
npm install
|
|
npm run build
|
|
```
|
|
|
|
## 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
|
|
|
|
```bash
|
|
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](CONTRIBUTING.md) for development guidelines.
|
|
|
|
## License
|
|
|
|
Apache License 2.0. See [LICENSE](LICENSE) for details.
|