reconciler

Documentation

Overview

Package reconciler defines implementations of the Reconciler interface defined at github.com/knative/pkg/controller.Reconciler. These implement the basic workhorse functionality of controllers, while leaving the shared controller implementation to manage things like the workqueue.

Despite defining a Reconciler, each of the packages here are expected to expose a controller constructor like:

func NewController(...) *controller.Impl { ... }

These constructors will:

1. Construct the Reconciler,
2. Construct a controller.Impl with that Reconciler,
3. Wire the assorted informers this Reconciler watches to call appropriate enqueue methods on the controller.

Index

• func Handler(h func(interface{})) cache.ResourceEventHandler
• func MakeObjectRef(a accessor, gvk schema.GroupVersionKind) corev1.ObjectReference
• func MustNewStatsReporter(reconciler string, logger *zap.SugaredLogger) controller.StatsReporter
• type Base
  • func NewBase(opt Options, controllerAgentName string) *Base
• type Options
  • func (o Options) GetTrackerLease() time.Duration

Functions

func Handler

func Handler(h func(interface{})) cache.ResourceEventHandler

Handler wraps the provided handler function into a cache.ResourceEventHandler that sends all events to the given handler. For Updates, only the new object is forwarded.

func MakeObjectRef

func MakeObjectRef(a accessor, gvk schema.GroupVersionKind) corev1.ObjectReference

func MustNewStatsReporter

func MustNewStatsReporter(reconciler string, logger *zap.SugaredLogger) controller.StatsReporter

MustNewStatsReporter creates a new instance of StatsReporter. Panics if creation fails.

Types

type Base

type Base struct {
	// KubeClientSet allows us to talk to the k8s for core APIs
	KubeClientSet kubernetes.Interface

	// ProjectriffClientSet allows us to configure projectriff objects
	ProjectriffClientSet projectriffclientset.Interface

	// KnBuildClientSet allows us to configure Knative build objects
	KnBuildClientSet knbuildclientset.Interface

	// KnServingClientSet allows us to configure Knative serving objects
	KnServingClientSet knservingclientset.Interface

	// ConfigMapWatcher allows us to watch for ConfigMap changes.
	ConfigMapWatcher configmap.Watcher

	// Recorder is an event recorder for recording Event resources to the
	// Kubernetes API.
	Recorder record.EventRecorder

	// Sugared logger is easier to use but is not as performant as the
	// raw logger. In performance critical paths, call logger.Desugar()
	// and use the returned raw logger instead. In addition to the
	// performance benefits, raw logger also preserves type-safety at
	// the expense of slightly greater verbosity.
	Logger *zap.SugaredLogger
}

Base implements the core controller logic, given a Reconciler.

func NewBase

func NewBase(opt Options, controllerAgentName string) *Base

NewBase instantiates a new instance of Base implementing the common & boilerplate code between our reconcilers.

type Options

type Options struct {
	KubeClientSet        kubernetes.Interface
	ProjectriffClientSet projectriffclientset.Interface
	KnBuildClientSet     knbuildclientset.Interface
	KnServingClientSet   knservingclientset.Interface
	Recorder             record.EventRecorder

	ConfigMapWatcher configmap.Watcher
	Logger           *zap.SugaredLogger

	ResyncPeriod time.Duration
	StopChannel  <-chan struct{}
}

Options defines the common reconciler options. We define this to reduce the boilerplate argument list when creating our controllers.

func (Options) GetTrackerLease

func (o Options) GetTrackerLease() time.Duration

GetTrackerLease returns a multiple of the resync period to use as the duration for tracker leases. This attempts to ensure that resyncs happen to refresh leases frequently enough that we don't miss updates to tracked objects.