Documentation

Overview

    Package controller contains code for controllers (like the replication controller).

    Index

    Constants

    View Source
    const (
    	// FailedCreatePodReason is added in an event and in a replica set condition
    	// when a pod for a replica set is failed to be created.
    	FailedCreatePodReason = "FailedCreate"
    	// SuccessfulCreatePodReason is added in an event when a pod for a replica set
    	// is successfully created.
    	SuccessfulCreatePodReason = "SuccessfulCreate"
    	// FailedDeletePodReason is added in an event and in a replica set condition
    	// when a pod for a replica set is failed to be deleted.
    	FailedDeletePodReason = "FailedDelete"
    	// SuccessfulDeletePodReason is added in an event when a pod for a replica set
    	// is successfully deleted.
    	SuccessfulDeletePodReason = "SuccessfulDelete"
    )

      Reasons for pod events

      View Source
      const (
      	// If a watch drops a delete event for a pod, it'll take this long
      	// before a dormant controller waiting for those packets is woken up anyway. It is
      	// specifically targeted at the case where some problem prevents an update
      	// of expectations, without it the controller could stay asleep forever. This should
      	// be set based on the expected latency of watch events.
      	//
      	// Currently a controller can service (create *and* observe the watch events for said
      	// creation) about 10 pods a second, so it takes about 1 min to service
      	// 500 pods. Just creation is limited to 20qps, and watching happens with ~10-30s
      	// latency/pod at the scale of 3000 pods over 100 nodes.
      	ExpectationsTimeout = 5 * time.Minute
      )

      Variables

      View Source
      var ExpKeyFunc = func(obj interface{}) (string, error) {
      	if e, ok := obj.(*ControlleeExpectations); ok {
      		return e.key, nil
      	}
      	return "", fmt.Errorf("Could not find key for obj %#v", obj)
      }

        ExpKeyFunc to parse out the key from a ControlleeExpectation

        View Source
        var UIDSetKeyFunc = func(obj interface{}) (string, error) {
        	if u, ok := obj.(*UIDSet); ok {
        		return u.key, nil
        	}
        	return "", fmt.Errorf("Could not find key for obj %#v", obj)
        }

          UIDSetKeyFunc to parse out the key from a UIDSet.

          View Source
          var UpdateTaintBackoff = wait.Backoff{
          	Steps:    5,
          	Duration: 100 * time.Millisecond,
          	Jitter:   1.0,
          }

          Functions

          func AddOrUpdateTaintOnNode

          func AddOrUpdateTaintOnNode(c clientset.Interface, nodeName string, taint *v1.Taint) error

          func FilterActivePods

          func FilterActivePods(pods []*v1.Pod) []*v1.Pod

            FilterActivePods returns pods that have not terminated.

            func FilterActiveReplicaSets

            func FilterActiveReplicaSets(replicaSets []*extensions.ReplicaSet) []*extensions.ReplicaSet

              FilterActiveReplicaSets returns replica sets that have (or at least ought to have) pods.

              func FilterReplicaSets

              func FilterReplicaSets(RSes []*extensions.ReplicaSet, filterFn filterRS) []*extensions.ReplicaSet

                FilterReplicaSets returns replica sets that are filtered by filterFn (all returned ones should match filterFn).

                func GetControllerOf

                func GetControllerOf(controllee metav1.Object) *metav1.OwnerReference

                  GetControllerOf returns the controllerRef if controllee has a controller, otherwise returns nil.

                  func GetPodFromTemplate

                  func GetPodFromTemplate(template *v1.PodTemplateSpec, parentObject runtime.Object, controllerRef *metav1.OwnerReference) (*v1.Pod, error)

                  func IsPodActive

                  func IsPodActive(p *v1.Pod) bool

                  func NoResyncPeriodFunc

                  func NoResyncPeriodFunc() time.Duration

                    Returns 0 for resyncPeriod in case resyncing is not needed.

                    func PatchNodeTaints

                    func PatchNodeTaints(c clientset.Interface, nodeName string, oldNode *v1.Node, newNode *v1.Node) error

                      PatchNodeTaints patches node's taints.

                      func PodKey

                      func PodKey(pod *v1.Pod) string

                        PodKey returns a key unique to the given pod within a cluster. It's used so we consistently use the same key scheme in this module. It does exactly what cache.MetaNamespaceKeyFunc would have done except there's not possibility for error since we know the exact type.

                        func RecheckDeletionTimestamp

                        func RecheckDeletionTimestamp(getObject func() (metav1.Object, error)) func() error

                          RecheckDeletionTimestamp returns a canAdopt() function to recheck deletion.

                          The canAdopt() function calls getObject() to fetch the latest value, and denies adoption attempts if that object has a non-nil DeletionTimestamp.

                          func RemoveTaintOffNode

                          func RemoveTaintOffNode(c clientset.Interface, nodeName string, taint *v1.Taint, node *v1.Node) error

                            RemoveTaintOffNode is for cleaning up taints temporarily added to node, won't fail if target taint doesn't exist or has been removed. If passed a node it'll check if there's anything to be done, if taint is not present it won't issue any API calls.

                            Types

                            type ActivePods

                            type ActivePods []*v1.Pod

                              ActivePods type allows custom sorting of pods so a controller can pick the best ones to delete.

                              func (ActivePods) Len

                              func (s ActivePods) Len() int

                              func (ActivePods) Less

                              func (s ActivePods) Less(i, j int) bool

                              func (ActivePods) Swap

                              func (s ActivePods) Swap(i, j int)

                              type ByLogging

                              type ByLogging []*v1.Pod

                                ByLogging allows custom sorting of pods so the best one can be picked for getting its logs.

                                func (ByLogging) Len

                                func (s ByLogging) Len() int

                                func (ByLogging) Less

                                func (s ByLogging) Less(i, j int) bool

                                func (ByLogging) Swap

                                func (s ByLogging) Swap(i, j int)

                                type ControlleeExpectations

                                type ControlleeExpectations struct {
                                	// contains filtered or unexported fields
                                }

                                  ControlleeExpectations track controllee creates/deletes.

                                  func (*ControlleeExpectations) Add

                                  func (e *ControlleeExpectations) Add(add, del int64)

                                    Add increments the add and del counters.

                                    func (*ControlleeExpectations) Fulfilled

                                    func (e *ControlleeExpectations) Fulfilled() bool

                                      Fulfilled returns true if this expectation has been fulfilled.

                                      func (*ControlleeExpectations) GetExpectations

                                      func (e *ControlleeExpectations) GetExpectations() (int64, int64)

                                        GetExpectations returns the add and del expectations of the controllee.

                                        type ControllerClientBuilder

                                        type ControllerClientBuilder interface {
                                        	Config(name string) (*restclient.Config, error)
                                        	ConfigOrDie(name string) *restclient.Config
                                        	Client(name string) (clientset.Interface, error)
                                        	ClientOrDie(name string) clientset.Interface
                                        	ClientGoClient(name string) (clientgoclientset.Interface, error)
                                        	ClientGoClientOrDie(name string) clientgoclientset.Interface
                                        }

                                          ControllerClientBuilder allow syou to get clients and configs for controllers

                                          type ControllerExpectations

                                          type ControllerExpectations struct {
                                          	cache.Store
                                          }

                                            ControllerExpectations is a cache mapping controllers to what they expect to see before being woken up for a sync.

                                            func NewControllerExpectations

                                            func NewControllerExpectations() *ControllerExpectations

                                              NewControllerExpectations returns a store for ControllerExpectations.

                                              func (*ControllerExpectations) CreationObserved

                                              func (r *ControllerExpectations) CreationObserved(controllerKey string)

                                                CreationObserved atomically decrements the `add` expectation count of the given controller.

                                                func (*ControllerExpectations) DeleteExpectations

                                                func (r *ControllerExpectations) DeleteExpectations(controllerKey string)

                                                  DeleteExpectations deletes the expectations of the given controller from the TTLStore.

                                                  func (*ControllerExpectations) DeletionObserved

                                                  func (r *ControllerExpectations) DeletionObserved(controllerKey string)

                                                    DeletionObserved atomically decrements the `del` expectation count of the given controller.

                                                    func (*ControllerExpectations) ExpectCreations

                                                    func (r *ControllerExpectations) ExpectCreations(controllerKey string, adds int) error

                                                    func (*ControllerExpectations) ExpectDeletions

                                                    func (r *ControllerExpectations) ExpectDeletions(controllerKey string, dels int) error

                                                    func (*ControllerExpectations) GetExpectations

                                                    func (r *ControllerExpectations) GetExpectations(controllerKey string) (*ControlleeExpectations, bool, error)

                                                      GetExpectations returns the ControlleeExpectations of the given controller.

                                                      func (*ControllerExpectations) LowerExpectations

                                                      func (r *ControllerExpectations) LowerExpectations(controllerKey string, add, del int)

                                                        Decrements the expectation counts of the given controller.

                                                        func (*ControllerExpectations) RaiseExpectations

                                                        func (r *ControllerExpectations) RaiseExpectations(controllerKey string, add, del int)

                                                          Increments the expectation counts of the given controller.

                                                          func (*ControllerExpectations) SatisfiedExpectations

                                                          func (r *ControllerExpectations) SatisfiedExpectations(controllerKey string) bool

                                                            SatisfiedExpectations returns true if the required adds/dels for the given controller have been observed. Add/del counts are established by the controller at sync time, and updated as controllees are observed by the controller manager.

                                                            func (*ControllerExpectations) SetExpectations

                                                            func (r *ControllerExpectations) SetExpectations(controllerKey string, add, del int) error

                                                              SetExpectations registers new expectations for the given controller. Forgets existing expectations.

                                                              type ControllerExpectationsInterface

                                                              type ControllerExpectationsInterface interface {
                                                              	GetExpectations(controllerKey string) (*ControlleeExpectations, bool, error)
                                                              	SatisfiedExpectations(controllerKey string) bool
                                                              	DeleteExpectations(controllerKey string)
                                                              	SetExpectations(controllerKey string, add, del int) error
                                                              	ExpectCreations(controllerKey string, adds int) error
                                                              	ExpectDeletions(controllerKey string, dels int) error
                                                              	CreationObserved(controllerKey string)
                                                              	DeletionObserved(controllerKey string)
                                                              	RaiseExpectations(controllerKey string, add, del int)
                                                              	LowerExpectations(controllerKey string, add, del int)
                                                              }

                                                                ControllerExpectationsInterface is an interface that allows users to set and wait on expectations. Only abstracted out for testing. Warning: if using KeyFunc it is not safe to use a single ControllerExpectationsInterface with different types of controllers, because the keys might conflict across types.

                                                                type ControllersByCreationTimestamp

                                                                type ControllersByCreationTimestamp []*v1.ReplicationController

                                                                  ControllersByCreationTimestamp sorts a list of ReplicationControllers by creation timestamp, using their names as a tie breaker.

                                                                  func (ControllersByCreationTimestamp) Len

                                                                  func (ControllersByCreationTimestamp) Less

                                                                  func (ControllersByCreationTimestamp) Swap

                                                                  func (o ControllersByCreationTimestamp) Swap(i, j int)

                                                                  type Expectations

                                                                  type Expectations interface {
                                                                  	Fulfilled() bool
                                                                  }

                                                                    Expectations are either fulfilled, or expire naturally.

                                                                    type FakePodControl

                                                                    type FakePodControl struct {
                                                                    	sync.Mutex
                                                                    	Templates      []v1.PodTemplateSpec
                                                                    	ControllerRefs []metav1.OwnerReference
                                                                    	DeletePodName  []string
                                                                    	Patches        [][]byte
                                                                    	Err            error
                                                                    }

                                                                    func (*FakePodControl) Clear

                                                                    func (f *FakePodControl) Clear()

                                                                    func (*FakePodControl) CreatePods

                                                                    func (f *FakePodControl) CreatePods(namespace string, spec *v1.PodTemplateSpec, object runtime.Object) error

                                                                    func (*FakePodControl) CreatePodsOnNode

                                                                    func (f *FakePodControl) CreatePodsOnNode(nodeName, namespace string, template *v1.PodTemplateSpec, object runtime.Object, controllerRef *metav1.OwnerReference) error

                                                                    func (*FakePodControl) CreatePodsWithControllerRef

                                                                    func (f *FakePodControl) CreatePodsWithControllerRef(namespace string, spec *v1.PodTemplateSpec, object runtime.Object, controllerRef *metav1.OwnerReference) error

                                                                    func (*FakePodControl) DeletePod

                                                                    func (f *FakePodControl) DeletePod(namespace string, podID string, object runtime.Object) error

                                                                    func (*FakePodControl) PatchPod

                                                                    func (f *FakePodControl) PatchPod(namespace, name string, data []byte) error

                                                                    type MatchingCache

                                                                    type MatchingCache struct {
                                                                    	// contains filtered or unexported fields
                                                                    }

                                                                      MatchingCache save label and selector matching relationship

                                                                      func NewMatchingCache

                                                                      func NewMatchingCache(maxCacheEntries int) *MatchingCache

                                                                        NewMatchingCache return a NewMatchingCache, which save label and selector matching relationship.

                                                                        func (*MatchingCache) Add

                                                                        func (c *MatchingCache) Add(labelObj objectWithMeta, selectorObj objectWithMeta)

                                                                          Add will add matching information to the cache.

                                                                          func (*MatchingCache) GetMatchingObject

                                                                          func (c *MatchingCache) GetMatchingObject(labelObj objectWithMeta) (controller interface{}, exists bool)

                                                                            GetMatchingObject lookup the matching object for a given object. Note: the cache information may be invalid since the controller may be deleted or updated, we need check in the external request to ensure the cache data is not dirty.

                                                                            func (*MatchingCache) InvalidateAll

                                                                            func (c *MatchingCache) InvalidateAll()

                                                                              InvalidateAll invalidate the whole cache.

                                                                              func (*MatchingCache) Update

                                                                              func (c *MatchingCache) Update(labelObj objectWithMeta, selectorObj objectWithMeta)

                                                                                Update update the cached matching information.

                                                                                type PodControlInterface

                                                                                type PodControlInterface interface {
                                                                                	// CreatePods creates new pods according to the spec.
                                                                                	CreatePods(namespace string, template *v1.PodTemplateSpec, object runtime.Object) error
                                                                                	// CreatePodsOnNode creates a new pod according to the spec on the specified node,
                                                                                	// and sets the ControllerRef.
                                                                                	CreatePodsOnNode(nodeName, namespace string, template *v1.PodTemplateSpec, object runtime.Object, controllerRef *metav1.OwnerReference) error
                                                                                	// CreatePodsWithControllerRef creates new pods according to the spec, and sets object as the pod's controller.
                                                                                	CreatePodsWithControllerRef(namespace string, template *v1.PodTemplateSpec, object runtime.Object, controllerRef *metav1.OwnerReference) error
                                                                                	// DeletePod deletes the pod identified by podID.
                                                                                	DeletePod(namespace string, podID string, object runtime.Object) error
                                                                                	// PatchPod patches the pod.
                                                                                	PatchPod(namespace, name string, data []byte) error
                                                                                }

                                                                                  PodControlInterface is an interface that knows how to add or delete pods created as an interface to allow testing.

                                                                                  type PodControllerRefManager

                                                                                  type PodControllerRefManager struct {
                                                                                  	// contains filtered or unexported fields
                                                                                  }

                                                                                  func NewPodControllerRefManager

                                                                                  func NewPodControllerRefManager(
                                                                                  	podControl PodControlInterface,
                                                                                  	controller metav1.Object,
                                                                                  	selector labels.Selector,
                                                                                  	controllerKind schema.GroupVersionKind,
                                                                                  	canAdopt func() error,
                                                                                  ) *PodControllerRefManager

                                                                                    NewPodControllerRefManager returns a PodControllerRefManager that exposes methods to manage the controllerRef of pods.

                                                                                    The canAdopt() function can be used to perform a potentially expensive check (such as a live GET from the API server) prior to the first adoption. It will only be called (at most once) if an adoption is actually attempted. If canAdopt() returns a non-nil error, all adoptions will fail.

                                                                                    NOTE: Once canAdopt() is called, it will not be called again by the same

                                                                                    PodControllerRefManager instance. Create a new instance if it makes
                                                                                    sense to check canAdopt() again (e.g. in a different sync pass).
                                                                                    

                                                                                    func (*PodControllerRefManager) AdoptPod

                                                                                    func (m *PodControllerRefManager) AdoptPod(pod *v1.Pod) error

                                                                                      AdoptPod sends a patch to take control of the pod. It returns the error if the patching fails.

                                                                                      func (*PodControllerRefManager) ClaimPods

                                                                                      func (m *PodControllerRefManager) ClaimPods(pods []*v1.Pod, filters ...func(*v1.Pod) bool) ([]*v1.Pod, error)

                                                                                        ClaimPods tries to take ownership of a list of Pods.

                                                                                        It will reconcile the following:

                                                                                        * Adopt orphans if the selector matches.
                                                                                        * Release owned objects if the selector no longer matches.
                                                                                        

                                                                                        Optional: If one or more filters are specified, a Pod will only be claimed if all filters return true.

                                                                                        A non-nil error is returned if some form of reconciliation was attemped and failed. Usually, controllers should try again later in case reconciliation is still needed.

                                                                                        If the error is nil, either the reconciliation succeeded, or no reconciliation was necessary. The list of Pods that you now own is returned.

                                                                                        func (*PodControllerRefManager) ReleasePod

                                                                                        func (m *PodControllerRefManager) ReleasePod(pod *v1.Pod) error

                                                                                          ReleasePod sends a patch to free the pod from the control of the controller. It returns the error if the patching fails. 404 and 422 errors are ignored.

                                                                                          type RSControlInterface

                                                                                          type RSControlInterface interface {
                                                                                          	PatchReplicaSet(namespace, name string, data []byte) error
                                                                                          }

                                                                                            RSControlInterface is an interface that knows how to add or delete ReplicaSets, as well as increment or decrement them. It is used by the deployment controller to ease testing of actions that it takes.

                                                                                            type RealPodControl

                                                                                            type RealPodControl struct {
                                                                                            	KubeClient clientset.Interface
                                                                                            	Recorder   record.EventRecorder
                                                                                            }

                                                                                              RealPodControl is the default implementation of PodControlInterface.

                                                                                              func (RealPodControl) CreatePods

                                                                                              func (r RealPodControl) CreatePods(namespace string, template *v1.PodTemplateSpec, object runtime.Object) error

                                                                                              func (RealPodControl) CreatePodsOnNode

                                                                                              func (r RealPodControl) CreatePodsOnNode(nodeName, namespace string, template *v1.PodTemplateSpec, object runtime.Object, controllerRef *metav1.OwnerReference) error

                                                                                              func (RealPodControl) CreatePodsWithControllerRef

                                                                                              func (r RealPodControl) CreatePodsWithControllerRef(namespace string, template *v1.PodTemplateSpec, controllerObject runtime.Object, controllerRef *metav1.OwnerReference) error

                                                                                              func (RealPodControl) DeletePod

                                                                                              func (r RealPodControl) DeletePod(namespace string, podID string, object runtime.Object) error

                                                                                              func (RealPodControl) PatchPod

                                                                                              func (r RealPodControl) PatchPod(namespace, name string, data []byte) error

                                                                                              type RealRSControl

                                                                                              type RealRSControl struct {
                                                                                              	KubeClient clientset.Interface
                                                                                              	Recorder   record.EventRecorder
                                                                                              }

                                                                                                RealRSControl is the default implementation of RSControllerInterface.

                                                                                                func (RealRSControl) PatchReplicaSet

                                                                                                func (r RealRSControl) PatchReplicaSet(namespace, name string, data []byte) error

                                                                                                type ReplicaSetControllerRefManager

                                                                                                type ReplicaSetControllerRefManager struct {
                                                                                                	// contains filtered or unexported fields
                                                                                                }

                                                                                                  ReplicaSetControllerRefManager is used to manage controllerRef of ReplicaSets. Three methods are defined on this object 1: Classify 2: AdoptReplicaSet and 3: ReleaseReplicaSet which are used to classify the ReplicaSets into appropriate categories and accordingly adopt or release them. See comments on these functions for more details.

                                                                                                  func NewReplicaSetControllerRefManager

                                                                                                  func NewReplicaSetControllerRefManager(
                                                                                                  	rsControl RSControlInterface,
                                                                                                  	controller metav1.Object,
                                                                                                  	selector labels.Selector,
                                                                                                  	controllerKind schema.GroupVersionKind,
                                                                                                  	canAdopt func() error,
                                                                                                  ) *ReplicaSetControllerRefManager

                                                                                                    NewReplicaSetControllerRefManager returns a ReplicaSetControllerRefManager that exposes methods to manage the controllerRef of ReplicaSets.

                                                                                                    The canAdopt() function can be used to perform a potentially expensive check (such as a live GET from the API server) prior to the first adoption. It will only be called (at most once) if an adoption is actually attempted. If canAdopt() returns a non-nil error, all adoptions will fail.

                                                                                                    NOTE: Once canAdopt() is called, it will not be called again by the same

                                                                                                    ReplicaSetControllerRefManager instance. Create a new instance if it
                                                                                                    makes sense to check canAdopt() again (e.g. in a different sync pass).
                                                                                                    

                                                                                                    func (*ReplicaSetControllerRefManager) AdoptReplicaSet

                                                                                                      AdoptReplicaSet sends a patch to take control of the ReplicaSet. It returns the error if the patching fails.

                                                                                                      func (*ReplicaSetControllerRefManager) ClaimReplicaSets

                                                                                                        ClaimReplicaSets tries to take ownership of a list of ReplicaSets.

                                                                                                        It will reconcile the following:

                                                                                                        * Adopt orphans if the selector matches.
                                                                                                        * Release owned objects if the selector no longer matches.
                                                                                                        

                                                                                                        A non-nil error is returned if some form of reconciliation was attemped and failed. Usually, controllers should try again later in case reconciliation is still needed.

                                                                                                        If the error is nil, either the reconciliation succeeded, or no reconciliation was necessary. The list of ReplicaSets that you now own is returned.

                                                                                                        func (*ReplicaSetControllerRefManager) ReleaseReplicaSet

                                                                                                        func (m *ReplicaSetControllerRefManager) ReleaseReplicaSet(replicaSet *extensions.ReplicaSet) error

                                                                                                          ReleaseReplicaSet sends a patch to free the ReplicaSet from the control of the Deployment controller. It returns the error if the patching fails. 404 and 422 errors are ignored.

                                                                                                          type ReplicaSetsByCreationTimestamp

                                                                                                          type ReplicaSetsByCreationTimestamp []*extensions.ReplicaSet

                                                                                                            ReplicaSetsByCreationTimestamp sorts a list of ReplicaSet by creation timestamp, using their names as a tie breaker.

                                                                                                            func (ReplicaSetsByCreationTimestamp) Len

                                                                                                            func (ReplicaSetsByCreationTimestamp) Less

                                                                                                            func (ReplicaSetsByCreationTimestamp) Swap

                                                                                                            func (o ReplicaSetsByCreationTimestamp) Swap(i, j int)

                                                                                                            type ReplicaSetsBySizeNewer

                                                                                                            type ReplicaSetsBySizeNewer []*extensions.ReplicaSet

                                                                                                              ReplicaSetsBySizeNewer sorts a list of ReplicaSet by size in descending order, using their creation timestamp or name as a tie breaker. By using the creation timestamp, this sorts from new to old replica sets.

                                                                                                              func (ReplicaSetsBySizeNewer) Len

                                                                                                              func (o ReplicaSetsBySizeNewer) Len() int

                                                                                                              func (ReplicaSetsBySizeNewer) Less

                                                                                                              func (o ReplicaSetsBySizeNewer) Less(i, j int) bool

                                                                                                              func (ReplicaSetsBySizeNewer) Swap

                                                                                                              func (o ReplicaSetsBySizeNewer) Swap(i, j int)

                                                                                                              type ReplicaSetsBySizeOlder

                                                                                                              type ReplicaSetsBySizeOlder []*extensions.ReplicaSet

                                                                                                                ReplicaSetsBySizeOlder sorts a list of ReplicaSet by size in descending order, using their creation timestamp or name as a tie breaker. By using the creation timestamp, this sorts from old to new replica sets.

                                                                                                                func (ReplicaSetsBySizeOlder) Len

                                                                                                                func (o ReplicaSetsBySizeOlder) Len() int

                                                                                                                func (ReplicaSetsBySizeOlder) Less

                                                                                                                func (o ReplicaSetsBySizeOlder) Less(i, j int) bool

                                                                                                                func (ReplicaSetsBySizeOlder) Swap

                                                                                                                func (o ReplicaSetsBySizeOlder) Swap(i, j int)

                                                                                                                type ResyncPeriodFunc

                                                                                                                type ResyncPeriodFunc func() time.Duration

                                                                                                                func StaticResyncPeriodFunc

                                                                                                                func StaticResyncPeriodFunc(resyncPeriod time.Duration) ResyncPeriodFunc

                                                                                                                  StaticResyncPeriodFunc returns the resync period specified

                                                                                                                  type SAControllerClientBuilder

                                                                                                                  type SAControllerClientBuilder struct {
                                                                                                                  	// ClientConfig is a skeleton config to clone and use as the basis for each controller client
                                                                                                                  	ClientConfig *restclient.Config
                                                                                                                  
                                                                                                                  	// CoreClient is used to provision service accounts if needed and watch for their associated tokens
                                                                                                                  	// to construct a controller client
                                                                                                                  	CoreClient v1core.CoreV1Interface
                                                                                                                  
                                                                                                                  	// AuthenticationClient is used to check API tokens to make sure they are valid before
                                                                                                                  	// building a controller client from them
                                                                                                                  	AuthenticationClient v1authentication.AuthenticationV1Interface
                                                                                                                  
                                                                                                                  	// Namespace is the namespace used to host the service accounts that will back the
                                                                                                                  	// controllers.  It must be highly privileged namespace which normal users cannot inspect.
                                                                                                                  	Namespace string
                                                                                                                  }

                                                                                                                    SAControllerClientBuilder is a ControllerClientBuilder that returns clients identifying as service accounts

                                                                                                                    func (SAControllerClientBuilder) Client

                                                                                                                    func (SAControllerClientBuilder) ClientGoClient

                                                                                                                    func (SAControllerClientBuilder) ClientGoClientOrDie

                                                                                                                    func (b SAControllerClientBuilder) ClientGoClientOrDie(name string) clientgoclientset.Interface

                                                                                                                    func (SAControllerClientBuilder) ClientOrDie

                                                                                                                    func (SAControllerClientBuilder) Config

                                                                                                                      config returns a complete clientConfig for constructing clients. This is separate in anticipation of composition which means that not all clientsets are known here

                                                                                                                      func (SAControllerClientBuilder) ConfigOrDie

                                                                                                                      func (b SAControllerClientBuilder) ConfigOrDie(name string) *restclient.Config

                                                                                                                      type SimpleControllerClientBuilder

                                                                                                                      type SimpleControllerClientBuilder struct {
                                                                                                                      	// ClientConfig is a skeleton config to clone and use as the basis for each controller client
                                                                                                                      	ClientConfig *restclient.Config
                                                                                                                      }

                                                                                                                        SimpleControllerClientBuilder returns a fixed client with different user agents

                                                                                                                        func (SimpleControllerClientBuilder) Client

                                                                                                                        func (SimpleControllerClientBuilder) ClientGoClient

                                                                                                                        func (SimpleControllerClientBuilder) ClientGoClientOrDie

                                                                                                                        func (SimpleControllerClientBuilder) ClientOrDie

                                                                                                                        func (SimpleControllerClientBuilder) Config

                                                                                                                        func (SimpleControllerClientBuilder) ConfigOrDie

                                                                                                                        type UIDSet

                                                                                                                        type UIDSet struct {
                                                                                                                        	sets.String
                                                                                                                        	// contains filtered or unexported fields
                                                                                                                        }

                                                                                                                          UIDSet holds a key and a set of UIDs. Used by the UIDTrackingControllerExpectations to remember which UID it has seen/still waiting for.

                                                                                                                          type UIDTrackingControllerExpectations

                                                                                                                          type UIDTrackingControllerExpectations struct {
                                                                                                                          	ControllerExpectationsInterface
                                                                                                                          	// contains filtered or unexported fields
                                                                                                                          }

                                                                                                                            UIDTrackingControllerExpectations tracks the UID of the pods it deletes. This cache is needed over plain old expectations to safely handle graceful deletion. The desired behavior is to treat an update that sets the DeletionTimestamp on an object as a delete. To do so consistenly, one needs to remember the expected deletes so they aren't double counted. TODO: Track creates as well (#22599)

                                                                                                                            func NewUIDTrackingControllerExpectations

                                                                                                                            func NewUIDTrackingControllerExpectations(ce ControllerExpectationsInterface) *UIDTrackingControllerExpectations

                                                                                                                              NewUIDTrackingControllerExpectations returns a wrapper around ControllerExpectations that is aware of deleteKeys.

                                                                                                                              func (*UIDTrackingControllerExpectations) DeleteExpectations

                                                                                                                              func (u *UIDTrackingControllerExpectations) DeleteExpectations(rcKey string)

                                                                                                                                DeleteExpectations deletes the UID set and invokes DeleteExpectations on the underlying ControllerExpectationsInterface.

                                                                                                                                func (*UIDTrackingControllerExpectations) DeletionObserved

                                                                                                                                func (u *UIDTrackingControllerExpectations) DeletionObserved(rcKey, deleteKey string)

                                                                                                                                  DeletionObserved records the given deleteKey as a deletion, for the given rc.

                                                                                                                                  func (*UIDTrackingControllerExpectations) ExpectDeletions

                                                                                                                                  func (u *UIDTrackingControllerExpectations) ExpectDeletions(rcKey string, deletedKeys []string) error

                                                                                                                                    ExpectDeletions records expectations for the given deleteKeys, against the given controller.

                                                                                                                                    func (*UIDTrackingControllerExpectations) GetUIDs

                                                                                                                                    func (u *UIDTrackingControllerExpectations) GetUIDs(controllerKey string) sets.String

                                                                                                                                      GetUIDs is a convenience method to avoid exposing the set of expected uids. The returned set is not thread safe, all modifications must be made holding the uidStoreLock.

                                                                                                                                      Directories

                                                                                                                                      Path Synopsis
                                                                                                                                      Package bootstrap provides automatic processes necessary for bootstraping.
                                                                                                                                      Package bootstrap provides automatic processes necessary for bootstraping.
                                                                                                                                      Package certificates contains logic for watching and synchronizing CertificateSigningRequests.
                                                                                                                                      Package certificates contains logic for watching and synchronizing CertificateSigningRequests.
                                                                                                                                      Package cronjob contains the controller for CronJob objects.
                                                                                                                                      Package cronjob contains the controller for CronJob objects.
                                                                                                                                      Package daemon contains logic for watching and synchronizing daemons.
                                                                                                                                      Package daemon contains logic for watching and synchronizing daemons.
                                                                                                                                      Package deployment contains all the logic for handling Kubernetes Deployments.
                                                                                                                                      Package deployment contains all the logic for handling Kubernetes Deployments.
                                                                                                                                      Package service provides EndpointController implementation to manage and sync service endpoints.
                                                                                                                                      Package service provides EndpointController implementation to manage and sync service endpoints.
                                                                                                                                      Package job contains logic for watching and synchronizing jobs.
                                                                                                                                      Package job contains logic for watching and synchronizing jobs.
                                                                                                                                      namespace contains a controller that handles namespace lifecycle
                                                                                                                                      namespace contains a controller that handles namespace lifecycle
                                                                                                                                      Package node contains code for syncing cloud instances with node registry
                                                                                                                                      Package node contains code for syncing cloud instances with node registry
                                                                                                                                      Package podautoscaler contains logic for autoscaling number of pods based on metrics observed.
                                                                                                                                      Package podautoscaler contains logic for autoscaling number of pods based on metrics observed.
                                                                                                                                      Package podgc contains a very simple pod "garbage collector" implementation, PodGCController, that runs in the controller manager.
                                                                                                                                      Package podgc contains a very simple pod "garbage collector" implementation, PodGCController, that runs in the controller manager.
                                                                                                                                      Package replicaset contains logic for watching and synchronizing ReplicaSets.
                                                                                                                                      Package replicaset contains logic for watching and synchronizing ReplicaSets.
                                                                                                                                      Package replication contains logic for watching and synchronizing replication controllers.
                                                                                                                                      Package replication contains logic for watching and synchronizing replication controllers.
                                                                                                                                      resourcequota contains a controller that makes resource quota usage observations
                                                                                                                                      resourcequota contains a controller that makes resource quota usage observations
                                                                                                                                      Package route contains code for syncing cloud routing rules with the list of registered nodes.
                                                                                                                                      Package route contains code for syncing cloud routing rules with the list of registered nodes.
                                                                                                                                      Package service contains code for syncing cloud load balancers with the service registry.
                                                                                                                                      Package service contains code for syncing cloud load balancers with the service registry.
                                                                                                                                      Package serviceaccount provides implementations to manage service accounts and service account tokens
                                                                                                                                      Package serviceaccount provides implementations to manage service accounts and service account tokens
                                                                                                                                      volume
                                                                                                                                      attachdetach
                                                                                                                                      Package volume implements a controller to manage volume attach and detach operations.
                                                                                                                                      Package volume implements a controller to manage volume attach and detach operations.
                                                                                                                                      attachdetach/cache
                                                                                                                                      Package cache implements data structures used by the attach/detach controller to keep track of volumes, the nodes they are attached to, and the pods that reference them.
                                                                                                                                      Package cache implements data structures used by the attach/detach controller to keep track of volumes, the nodes they are attached to, and the pods that reference them.
                                                                                                                                      attachdetach/populator
                                                                                                                                      Package populator implements interfaces that monitor and keep the states of the desired_state_of_word in sync with the "ground truth" from informer.
                                                                                                                                      Package populator implements interfaces that monitor and keep the states of the desired_state_of_word in sync with the "ground truth" from informer.
                                                                                                                                      attachdetach/reconciler
                                                                                                                                      Package reconciler implements interfaces that attempt to reconcile the desired state of the with the actual state of the world by triggering actions.
                                                                                                                                      Package reconciler implements interfaces that attempt to reconcile the desired state of the with the actual state of the world by triggering actions.
                                                                                                                                      attachdetach/statusupdater
                                                                                                                                      Package statusupdater implements interfaces that enable updating the status of API objects.
                                                                                                                                      Package statusupdater implements interfaces that enable updating the status of API objects.