options

pkg/manager/options

Intention

pkg/manager/options is the controller-specific layer on top of pkg/options. It defines the common runtime flags needed by controller binaries in this repository after the generic process bootstrap concerns have already been handled.

This package is not a general controller configuration framework. It is the shared flag surface for controller processes that use pkg/manager.

What Lives Here

• Options, which embeds options.CoreOptions and adds:
  • MaxConcurrentReconciles
  • CDDriver
• AddFlags(), which registers those controller-specific flags and seeds the default CD driver.

Relationships

• pkg/options provides the common process-bootstrap layer for logging, telemetry, namespace scoping, and similar runtime concerns.
• pkg/manager is the runtime layer that consumes these options when starting controller processes.

Invariants

• Controller binaries should embed or reuse this options struct rather than re-declaring common manager flags in each command.
• MaxConcurrentReconciles is the shared tuning knob for controller throughput and memory tradeoffs.
• CDDriver exists because the manager layer still carries legacy in-tree CD integration and needs one common way to select that backend.

Caveats

• This package inherits the same strategic blemish as pkg/manager: the CD-driver flag is legacy surface tied to the old in-tree CD model.
• The option set is intentionally small. If more flags accumulate here, that is a sign the controller layer may be leaking service-specific policy into what should stay a shared manager bootstrap surface.