Skip to content

Nextdoor/veneer

Repository files navigation

Veneer

Cost-aware Karpenter provisioning via NodeOverlay management

Veneer is a Kubernetes controller that optimizes Karpenter provisioning decisions by managing NodeOverlay resources based on real-time AWS Reserved Instance and Savings Plans data from Lumina. It automatically prefers RI/SP-covered on-demand instances when cost-effective and falls back to spot when capacity is exhausted.

Full documentation: https://oss.nextdoor.com/veneer/docs/

Install

helm install veneer ./charts/veneer \
  --namespace veneer-system \
  --create-namespace \
  --set prometheusUrl=http://lumina-prometheus.lumina-system.svc:9090

Documentation

Topic Link
Getting Started Quick Start Guide
Concepts Architecture & Concepts
Instance Selection How Karpenter Selects Instances
Bin-Packing Bin-Packing & NodeOverlay
Configuration Configuration Reference
Instance Preferences NodePool Preference Annotations
Development Development Guide

Quick Start (Development)

make build    # Auto-installs Go into ./bin/go/
make test     # Run tests
make lint     # Lint

See the Development Guide for full instructions.

Contributing

See the Development Guide for setup, testing, code style, and contribution workflow.

License

Copyright 2025 Nextdoor, Inc. Licensed under the Apache License, Version 2.0.

Credits

Built by the Nextdoor Cloud Engineering team as a companion to Lumina.