Documentation

Overview

Package controller provides types and functions for building Controllers. Controllers implement Kubernetes APIs.

Creation

To create a new Controller, first create a manager.Manager and pass it to the controller.New function. The Controller MUST be started by calling Manager.Start.

Index

Examples

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Controller

type Controller interface {
	// Reconciler is called to Reconciler an object by Namespace/Name
	reconcile.Reconciler

	// Watch takes events provided by a Source and uses the EventHandler to enqueue reconcile.Requests in
	// response to the events.
	//
	// Watch may be provided one or more Predicates to filter events before they are given to the EventHandler.
	// Events will be passed to the EventHandler iff all provided Predicates evaluate to true.
	Watch(src source.Source, eventhandler handler.EventHandler, predicates ...predicate.Predicate) error

	// Start starts the controller.  Start blocks until stop is closed or a controller has an error starting.
	Start(stop <-chan struct{}) error
}

    Controller implements a Kubernetes API. A Controller manages a work queue fed reconcile.Requests from source.Sources. Work is performed through the reconcile.Reconciler for each enqueued item. Work typically is reads and writes Kubernetes objects to make the system state match the state specified in the object Spec.

    Example

      This example starts a new Controller named "pod-controller" to Watch Pods and call a no-op Reconciler.

      Output:
      
      
      Example (Unstructured)

        This example starts a new Controller named "pod-controller" to Watch Pods with the unstructured object and call a no-op Reconciler.

        Output:
        
        

        func New

        func New(name string, mgr manager.Manager, options Options) (Controller, error)

          New returns a new Controller registered with the Manager. The Manager will ensure that shared Caches have been synced before the Controller is Started.

          Example

            This example creates a new Controller named "pod-controller" with a no-op reconcile function. The manager.Manager will be used to Start the Controller, and will provide it a shared Cache and Client.

            Output:
            
            

            type Options

            type Options struct {
            	// MaxConcurrentReconciles is the maximum number of concurrent Reconciles which can be run. Defaults to 1.
            	MaxConcurrentReconciles int
            
            	// Reconciler reconciles an object
            	Reconciler reconcile.Reconciler
            }

              Options are the arguments for creating a new Controller

              Directories

              Path Synopsis
              Package controllertest contains fake informers for testing controllers
              Package controllertest contains fake informers for testing controllers
              Package controllerutil contains utility functions for working with and implementing Controllers.
              Package controllerutil contains utility functions for working with and implementing Controllers.