Documentation
¶
Overview ¶
Package controller is the one general reconcile engine (ADR-0015): a store-watch informer feeds a rate-limited, deduplicating workqueue that worker goroutines drain by calling each kind's registered Reconciler — with exponential-backoff retry, RequeueAfter, status write-back (the reconciler's), and clean shutdown. Every control-plane feature contributes only a Reconciler; the engine owns the watch/queue/retry/worker machinery. k8s-free (the workqueue is hand-written).
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Controller ¶
type Controller struct {
// contains filtered or unexported fields
}
Controller is the reconcile engine.
func (*Controller) Register ¶
func (c *Controller) Register(gvk v1.GroupVersionKind, r Reconciler)
Register binds a Reconciler to a gvk. Call before Run.
type Deps ¶
type Deps struct {
Store store.Store
Logger *slog.Logger
Workers int // number of worker goroutines; <1 defaults to 1
}
Deps configures the engine (internal component, ADR-0002 §1).
type Reconciler ¶
Reconciler is the per-kind logic a feature contributes. It must be idempotent (the queue is at-least-once). A delete surfaces as fault.NotFound from the store.
type Request ¶
type Request struct {
GVK v1.GroupVersionKind
Namespace v1.NamespaceName
Name v1.ObjectName
}
Request identifies the object to reconcile; it is also the workqueue key (comparable).
Source Files