Documentation ¶
Overview ¶
Package controller contains code for controllers (like the replication controller).
Index ¶
- Constants
- Variables
- func FilterActivePods(pods []*v1.Pod) []*v1.Pod
- func FilterActiveReplicaSets(replicaSets []*extensions.ReplicaSet) []*extensions.ReplicaSet
- func GetControllerOf(controllee *metav1.ObjectMeta) *metav1.OwnerReference
- func GetPodFromTemplate(template *v1.PodTemplateSpec, parentObject runtime.Object, ...) (*v1.Pod, error)
- func IsPodActive(p *v1.Pod) bool
- func NoResyncPeriodFunc() time.Duration
- func PodKey(pod *v1.Pod) string
- type ActivePods
- type ByLogging
- type ControlleeExpectations
- type ControllerClientBuilder
- type ControllerExpectations
- func (r *ControllerExpectations) CreationObserved(controllerKey string)
- func (r *ControllerExpectations) DeleteExpectations(controllerKey string)
- func (r *ControllerExpectations) DeletionObserved(controllerKey string)
- func (r *ControllerExpectations) ExpectCreations(controllerKey string, adds int) error
- func (r *ControllerExpectations) ExpectDeletions(controllerKey string, dels int) error
- func (r *ControllerExpectations) GetExpectations(controllerKey string) (*ControlleeExpectations, bool, error)
- func (r *ControllerExpectations) LowerExpectations(controllerKey string, add, del int)
- func (r *ControllerExpectations) RaiseExpectations(controllerKey string, add, del int)
- func (r *ControllerExpectations) SatisfiedExpectations(controllerKey string) bool
- func (r *ControllerExpectations) SetExpectations(controllerKey string, add, del int) error
- type ControllerExpectationsInterface
- type ControllersByCreationTimestamp
- type Expectations
- type FakePodControl
- func (f *FakePodControl) Clear()
- func (f *FakePodControl) CreatePods(namespace string, spec *v1.PodTemplateSpec, object runtime.Object) error
- func (f *FakePodControl) CreatePodsOnNode(nodeName, namespace string, template *v1.PodTemplateSpec, ...) error
- func (f *FakePodControl) CreatePodsWithControllerRef(namespace string, spec *v1.PodTemplateSpec, object runtime.Object, ...) error
- func (f *FakePodControl) DeletePod(namespace string, podID string, object runtime.Object) error
- func (f *FakePodControl) PatchPod(namespace, name string, data []byte) error
- type MatchingCache
- func (c *MatchingCache) Add(labelObj objectWithMeta, selectorObj objectWithMeta)
- func (c *MatchingCache) GetMatchingObject(labelObj objectWithMeta) (controller interface{}, exists bool)
- func (c *MatchingCache) InvalidateAll()
- func (c *MatchingCache) Update(labelObj objectWithMeta, selectorObj objectWithMeta)
- type PodControlInterface
- type PodControllerRefManager
- type RSControlInterface
- type RealPodControl
- func (r RealPodControl) CreatePods(namespace string, template *v1.PodTemplateSpec, object runtime.Object) error
- func (r RealPodControl) CreatePodsOnNode(nodeName, namespace string, template *v1.PodTemplateSpec, ...) error
- func (r RealPodControl) CreatePodsWithControllerRef(namespace string, template *v1.PodTemplateSpec, ...) error
- func (r RealPodControl) DeletePod(namespace string, podID string, object runtime.Object) error
- func (r RealPodControl) PatchPod(namespace, name string, data []byte) error
- type RealRSControl
- type ReplicaSetControllerRefManager
- func (m *ReplicaSetControllerRefManager) AdoptReplicaSet(replicaSet *extensions.ReplicaSet) error
- func (m *ReplicaSetControllerRefManager) Classify(replicaSets []*extensions.ReplicaSet) (matchesAndControlled []*extensions.ReplicaSet, ...)
- func (m *ReplicaSetControllerRefManager) ReleaseReplicaSet(replicaSet *extensions.ReplicaSet) error
- type ReplicaSetsByCreationTimestamp
- type ReplicaSetsBySizeNewer
- type ReplicaSetsBySizeOlder
- type ResyncPeriodFunc
- type SAControllerClientBuilder
- func (b SAControllerClientBuilder) Client(name string) (clientset.Interface, error)
- func (b SAControllerClientBuilder) ClientGoClient(name string) (clientgoclientset.Interface, error)
- func (b SAControllerClientBuilder) ClientGoClientOrDie(name string) clientgoclientset.Interface
- func (b SAControllerClientBuilder) ClientOrDie(name string) clientset.Interface
- func (b SAControllerClientBuilder) Config(name string) (*restclient.Config, error)
- func (b SAControllerClientBuilder) ConfigOrDie(name string) *restclient.Config
- type SimpleControllerClientBuilder
- func (b SimpleControllerClientBuilder) Client(name string) (clientset.Interface, error)
- func (b SimpleControllerClientBuilder) ClientGoClient(name string) (clientgoclientset.Interface, error)
- func (b SimpleControllerClientBuilder) ClientGoClientOrDie(name string) clientgoclientset.Interface
- func (b SimpleControllerClientBuilder) ClientOrDie(name string) clientset.Interface
- func (b SimpleControllerClientBuilder) Config(name string) (*restclient.Config, error)
- func (b SimpleControllerClientBuilder) ConfigOrDie(name string) *restclient.Config
- type UIDSet
- type UIDTrackingControllerExpectations
- func (u *UIDTrackingControllerExpectations) DeleteExpectations(rcKey string)
- func (u *UIDTrackingControllerExpectations) DeletionObserved(rcKey, deleteKey string)
- func (u *UIDTrackingControllerExpectations) ExpectDeletions(rcKey string, deletedKeys []string) error
- func (u *UIDTrackingControllerExpectations) GetUIDs(controllerKey string) sets.String
Constants ¶
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
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 ¶
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
var (
KeyFunc = cache.DeletionHandlingMetaNamespaceKeyFunc
)
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.
Functions ¶
func FilterActivePods ¶
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 GetControllerOf ¶
func GetControllerOf(controllee *metav1.ObjectMeta) *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 NoResyncPeriodFunc ¶
Returns 0 for resyncPeriod in case resyncing is not needed.
Types ¶
type ActivePods ¶
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 ¶
ByLogging allows custom sorting of pods so the best one can be picked for getting its logs.
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 ¶
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 (o ControllersByCreationTimestamp) Len() int
func (ControllersByCreationTimestamp) Less ¶
func (o ControllersByCreationTimestamp) Less(i, j int) bool
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) error
func (*FakePodControl) CreatePodsWithControllerRef ¶
func (f *FakePodControl) CreatePodsWithControllerRef(namespace string, spec *v1.PodTemplateSpec, object runtime.Object, controllerRef *metav1.OwnerReference) 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. CreatePodsOnNode(nodeName, namespace string, template *v1.PodTemplateSpec, object runtime.Object) 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, controllerObject metav1.ObjectMeta, controllerSelector labels.Selector, controllerKind schema.GroupVersionKind, ) *PodControllerRefManager
NewPodControllerRefManager returns a PodControllerRefManager that exposes methods to manage the controllerRef of pods.
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) Classify ¶
func (m *PodControllerRefManager) Classify(pods []*v1.Pod) ( matchesAndControlled []*v1.Pod, matchesNeedsController []*v1.Pod, controlledDoesNotMatch []*v1.Pod)
Classify first filters out inactive pods, then it classify the remaining pods into three categories: 1. matchesAndControlled are the pods whose labels match the selector of the RC, and have a controllerRef pointing to the controller 2. matchesNeedsController are the pods whose labels match the RC, but don't have a controllerRef. (Pods with matching labels but with a controllerRef pointing to other object are ignored) 3. controlledDoesNotMatch are the pods that have a controllerRef pointing to the controller, but their labels no longer match the selector.
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 ¶
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) error
func (RealPodControl) CreatePodsWithControllerRef ¶
func (r RealPodControl) CreatePodsWithControllerRef(namespace string, template *v1.PodTemplateSpec, controllerObject runtime.Object, controllerRef *metav1.OwnerReference) 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, controllerObject metav1.ObjectMeta, controllerSelector labels.Selector, controllerKind schema.GroupVersionKind, ) *ReplicaSetControllerRefManager
NewReplicaSetControllerRefManager returns a ReplicaSetControllerRefManager that exposes methods to manage the controllerRef of ReplicaSets.
func (*ReplicaSetControllerRefManager) AdoptReplicaSet ¶
func (m *ReplicaSetControllerRefManager) AdoptReplicaSet(replicaSet *extensions.ReplicaSet) error
AdoptReplicaSet sends a patch to take control of the ReplicaSet. It returns the error if the patching fails.
func (*ReplicaSetControllerRefManager) Classify ¶
func (m *ReplicaSetControllerRefManager) Classify(replicaSets []*extensions.ReplicaSet) ( matchesAndControlled []*extensions.ReplicaSet, matchesNeedsController []*extensions.ReplicaSet, controlledDoesNotMatch []*extensions.ReplicaSet)
Classify, classifies the ReplicaSets into three categories: 1. matchesAndControlled are the ReplicaSets whose labels match the selector of the Deployment, and have a controllerRef pointing to the Deployment. 2. matchesNeedsController are ReplicaSets ,whose labels match the Deployment, but don't have a controllerRef. (ReplicaSets with matching labels but with a controllerRef pointing to other object are ignored) 3. controlledDoesNotMatch are the ReplicaSets that have a controllerRef pointing to the Deployment, but their labels no longer match the selector.
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 (o ReplicaSetsByCreationTimestamp) Len() int
func (ReplicaSetsByCreationTimestamp) Less ¶
func (o ReplicaSetsByCreationTimestamp) Less(i, j int) bool
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 ¶
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 // 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 (b SAControllerClientBuilder) Client(name string) (clientset.Interface, error)
func (SAControllerClientBuilder) ClientGoClient ¶
func (b SAControllerClientBuilder) ClientGoClient(name string) (clientgoclientset.Interface, error)
func (SAControllerClientBuilder) ClientGoClientOrDie ¶
func (b SAControllerClientBuilder) ClientGoClientOrDie(name string) clientgoclientset.Interface
func (SAControllerClientBuilder) ClientOrDie ¶
func (b SAControllerClientBuilder) ClientOrDie(name string) clientset.Interface
func (SAControllerClientBuilder) Config ¶
func (b SAControllerClientBuilder) Config(name string) (*restclient.Config, error)
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 (b SimpleControllerClientBuilder) Client(name string) (clientset.Interface, error)
func (SimpleControllerClientBuilder) ClientGoClient ¶
func (b SimpleControllerClientBuilder) ClientGoClient(name string) (clientgoclientset.Interface, error)
func (SimpleControllerClientBuilder) ClientGoClientOrDie ¶
func (b SimpleControllerClientBuilder) ClientGoClientOrDie(name string) clientgoclientset.Interface
func (SimpleControllerClientBuilder) ClientOrDie ¶
func (b SimpleControllerClientBuilder) ClientOrDie(name string) clientset.Interface
func (SimpleControllerClientBuilder) Config ¶
func (b SimpleControllerClientBuilder) Config(name string) (*restclient.Config, error)
func (SimpleControllerClientBuilder) ConfigOrDie ¶
func (b SimpleControllerClientBuilder) ConfigOrDie(name string) *restclient.Config
type UIDSet ¶
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.
Source Files ¶
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. |