This Headlamp plugin adds Karpenter-specific custom resources to the Headlamp UI, helping users visualize, understand, and manage autoscaling decisions in a more intuitive way.
The plugin automatically detects and supports multiple Karpenter deployment types:
- EKS Auto Mode - AWS managed Karpenter with
NodeClassresources (nodeclasses.eks.amazonaws.com) - Self-installed Karpenter - Standard Karpenter installation with
EC2NodeClassresources (ec2nodeclasses.karpenter.k8s.aws) - Generic Karpenter - Other Karpenter installations with
NodeClassresources (nodeclasses.karpenter.sh)
- NodeClass Visualization:
- Clean UI to view Karpenter NodeClass/EC2NodeClass CRs
- Automatic detection of deployment type (EKS Auto Mode vs self-installed)
- Shows key attributes (subnet selectors, IAM role, etc.)
- Status and condition rendering in a human-readable format
- Supports both
NodeClass(EKS Auto Mode) andEC2NodeClass(self-installed) resources
- NodeClaim & NodePool Support:
- View and inspect NodeClaims and NodePools
- See constraints like CPU, requirements, disruption etc.
- Real-time status monitoring and configuration details
- Pending Pod Dashboard:
- Displays pending pods blocked from scheduling
- Shows unmet requirements
- Highlights why pods couldn't be scheduled
- CRD Editing:
- Use Headlamp’s editor to configure Karpenter CRDs
- Includes schema validation and diff preview
- Metrics Integration:
- Prometheus integration for comprehensive metrics visualization
- Resource Usage, Allowed Disruptions and Pending Pods visualization (NodePools)
- Creation Rate and Provisioning Latency visualization (Scaling View)
- Maps View:
- See relationship between Karpenter Resources like NodeClasses, NodePool and NodeClaims with core Kubernetes resources like Pods, Nodes etc.
- Automatic Deployment Detection:
- Automatically detects EKS Auto Mode vs self-installed Karpenter
- Adapts UI and resource handling based on detected deployment type
- No manual configuration required
The plugin works with both EKS Auto Mode and self-installed Karpenter:
- 📘 EKS Auto Mode Documentation
- Uses AWS-managed Karpenter with
NodeClassresources - Automatically detected by the plugin
- 📘 Karpenter Official Setup Guide
- Uses
EC2NodeClassresources that you manage - Requires manual installation and configuration
The plugin automatically detects which deployment type you're using and adapts accordingly.
The plugin examines available Custom Resource Definitions (CRDs) in your cluster:
- EKS Auto Mode: Detected by presence of
nodeclasses.eks.amazonaws.comCRD - Self-installed Karpenter: Detected by presence of
ec2nodeclasses.karpenter.k8s.awsCRD - Generic Karpenter: Detected by presence of
nodeclasses.karpenter.shCRD
Detection happens automatically when the plugin loads, with no configuration required.
Here is one demo video of the diff editor:
Screencast.from.2025-07-23.22-59-40.webm
Please see this and other closed PRs which have descriptions and more videos and screenshots of the features.
This plugin should work with most Karpenter providers, but has only so far been tested on the ones listed in the table. Additionally, each provider gives some extra information, and the ones in the table below are displayed by the plugin.
Please submit an issue if you test one of the untested providers or if you want support for this provider (PRs also gladly accepted).
| Provider Name | Tested | Extra provider specific info supported | Deployment Types |
|---|---|---|---|
| AWS | ✅ | ✅ | EKS Auto Mode, Self-installed |
| Azure | ✅ | ✅ | Self-installed |
| AlibabaCloud | ❌ | ❌ | Self-installed |
| Bizfly Cloud | ❌ | ❌ | Self-installed |
| Cluster API | ❌ | ❌ | Self-installed |
| GCP | ❌ | ❌ | Self-installed |
| Proxmox | ❌ | ❌ | Self-installed |
| Oracle Cloud Infrastructure (OCI) | ❌ | ❌ | Self-installed |
Please submit an issue if you use Karpenter and have any other ideas or feedback. Or come to the Kubernetes slack headlamp channel for a chat.
- Node.js and npm
- Docker
- Helm
- A Kubernetes cluster with Karpenter installed
-
Clone the plugin repository:
git clone https://github.com/headlamp-k8s/plugins.git
-
Navigate to karpenter plugin directory
cd karpenter -
Install all the required dependencies
npm install
-
Start the plugin in development mode
npm start
-
Launch Headlamp. You should now see "Karpenter" in the sidebar.