unkinben
274c480b09
bootapi replaces Cobbler's PXE/kickstart side. It resolves a PXE-booting host
from NetBox (by MAC or hostname), renders an iPXE boot script and a kickstart
from Go text/templates, and serves them over HTTP. The ENC half already moved to
encapi; this covers the provisioning/boot half.
What's here:
- cmd/bootapi + internal/{config,model,netbox,render,server}; embedded default
templates under templates/ (AlmaLinux 9 + Fedora kickstarts, iPXE boot +
unknown-MAC fallbacks) ported from Cobbler's boot/bootstrap contract.
- NetBox client (v4.x API) behind a Resolver interface with a short-TTL cache;
tested against httptest fixtures using real NetBox JSON shapes.
- chi HTTP server: /ipxe/{mac}, /boot/ipxe?mac=, /ks/{ident}, healthz/readyz,
Prometheus /metrics. Unknown MAC -> safe fallback iPXE (200), unknown KS -> 404.
- Secrets (root pw hash, ssh keys) injected at render time from env/Vault, never
NetBox. Config is env-based per estate convention.
- Makefile (build/test/lint/docker + patch/minor/major), Dockerfile (distroless),
.woodpecker (pre-commit, golangci-lint v2 + go test -race, docker build on PR;
image push + Gitea binary release on v* tag), docs/ and example config.
go build/vet clean, go test -race green, golangci-lint v2 clean, pre-commit clean.
Claude-Session: https://claude.ai/code/session_015ur3i7D2azsMAWTSVABApv
83 lines
2.8 KiB
Go
83 lines
2.8 KiB
Go
package server
|
|
|
|
import (
|
|
"github.com/prometheus/client_golang/prometheus"
|
|
"github.com/prometheus/client_golang/prometheus/collectors"
|
|
)
|
|
|
|
// cacheStats is the read side of the NetBox cache the collector publishes.
|
|
type cacheStats interface {
|
|
Hits() int64
|
|
Misses() int64
|
|
}
|
|
|
|
// metrics holds bootapi's Prometheus instruments, registered on a private
|
|
// registry so tests can construct isolated servers.
|
|
type metrics struct {
|
|
reg *prometheus.Registry
|
|
|
|
httpRequests *prometheus.CounterVec // by endpoint,status
|
|
renders *prometheus.CounterVec // by kind,result
|
|
netboxLookups *prometheus.CounterVec // by field,result
|
|
netboxDuration *prometheus.HistogramVec
|
|
}
|
|
|
|
func newMetrics(cache cacheStats) *metrics {
|
|
reg := prometheus.NewRegistry()
|
|
m := &metrics{
|
|
reg: reg,
|
|
httpRequests: prometheus.NewCounterVec(prometheus.CounterOpts{
|
|
Name: "bootapi_http_requests_total",
|
|
Help: "HTTP requests handled, by endpoint and status class.",
|
|
}, []string{"endpoint", "status"}),
|
|
renders: prometheus.NewCounterVec(prometheus.CounterOpts{
|
|
Name: "bootapi_render_total",
|
|
Help: "Template renders, by kind (kickstart|ipxe) and result (ok|error).",
|
|
}, []string{"kind", "result"}),
|
|
netboxLookups: prometheus.NewCounterVec(prometheus.CounterOpts{
|
|
Name: "bootapi_netbox_lookups_total",
|
|
Help: "NetBox host resolutions, by field (mac|name) and result (ok|notfound|error).",
|
|
}, []string{"field", "result"}),
|
|
netboxDuration: prometheus.NewHistogramVec(prometheus.HistogramOpts{
|
|
Name: "bootapi_netbox_lookup_duration_seconds",
|
|
Help: "Latency of NetBox host resolutions.",
|
|
Buckets: prometheus.DefBuckets,
|
|
}, []string{"field"}),
|
|
}
|
|
reg.MustRegister(m.httpRequests, m.renders, m.netboxLookups, m.netboxDuration)
|
|
if cache != nil {
|
|
reg.MustRegister(newCacheCollector(cache))
|
|
}
|
|
reg.MustRegister(
|
|
collectors.NewGoCollector(),
|
|
collectors.NewProcessCollector(collectors.ProcessCollectorOpts{}),
|
|
)
|
|
return m
|
|
}
|
|
|
|
// cacheCollector publishes the NetBox cache hit/miss counters, which live on
|
|
// the Cache itself (atomic ints) rather than in a CounterVec.
|
|
type cacheCollector struct {
|
|
stats cacheStats
|
|
hits *prometheus.Desc
|
|
miss *prometheus.Desc
|
|
}
|
|
|
|
func newCacheCollector(s cacheStats) *cacheCollector {
|
|
return &cacheCollector{
|
|
stats: s,
|
|
hits: prometheus.NewDesc("bootapi_netbox_cache_hits_total", "NetBox cache hits.", nil, nil),
|
|
miss: prometheus.NewDesc("bootapi_netbox_cache_misses_total", "NetBox cache misses.", nil, nil),
|
|
}
|
|
}
|
|
|
|
func (c *cacheCollector) Describe(ch chan<- *prometheus.Desc) {
|
|
ch <- c.hits
|
|
ch <- c.miss
|
|
}
|
|
|
|
func (c *cacheCollector) Collect(ch chan<- prometheus.Metric) {
|
|
ch <- prometheus.MustNewConstMetric(c.hits, prometheus.CounterValue, float64(c.stats.Hits()))
|
|
ch <- prometheus.MustNewConstMetric(c.miss, prometheus.CounterValue, float64(c.stats.Misses()))
|
|
}
|