state

Documentation

Index

• type Cluster
  • func NewCluster(clk clock.Clock, cfg config.Config, client client.Client, ...) *Cluster
  • func (c *Cluster) ClusterConsolidationState() int64
  • func (c *Cluster) ForEachNode(f func(n *Node) bool)
  • func (c *Cluster) ForPodsWithAntiAffinity(fn func(p *v1.Pod, n *v1.Node) bool)
  • func (c *Cluster) IsNodeNominated(nodeName string) bool
  • func (c *Cluster) LastNodeCreationTime() time.Time
  • func (c *Cluster) LastNodeDeletionTime() time.Time
  • func (c *Cluster) LivenessProbe(req *http.Request) error
  • func (c *Cluster) MarkForDeletion(nodeName string)
  • func (c *Cluster) NominateNodeForPod(nodeName string)
  • func (c *Cluster) Synchronized(ctx context.Context) error
  • func (c *Cluster) UnmarkForDeletion(nodeName string)
• type Node
  • func (in *Node) DeepCopy() *Node
  • func (in *Node) DeepCopyInto(out *Node)
• type NodeController
  • func NewNodeController(kubeClient client.Client, cluster *Cluster) *NodeController
  • func (c *NodeController) LivenessProbe(req *http.Request) error
  • func (c *NodeController) Reconcile(ctx context.Context, req reconcile.Request) (reconcile.Result, error)
  • func (c *NodeController) Register(ctx context.Context, m manager.Manager) error
• type PodController
  • func NewPodController(kubeClient client.Client, cluster *Cluster) *PodController
  • func (c *PodController) Reconcile(ctx context.Context, req reconcile.Request) (reconcile.Result, error)
  • func (c *PodController) Register(ctx context.Context, m manager.Manager) error
• type ProvisionerController
  • func NewProvisionerController(kubeClient client.Client, cluster *Cluster) *ProvisionerController
  • func (c *ProvisionerController) Reconcile(ctx context.Context, req reconcile.Request) (reconcile.Result, error)
  • func (c *ProvisionerController) Register(ctx context.Context, m manager.Manager) error

Types

type Cluster

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

Cluster maintains cluster state that is often needed but expensive to compute.

func NewCluster

func NewCluster(clk clock.Clock, cfg config.Config, client client.Client, cp cloudprovider.CloudProvider) *Cluster

func (*Cluster) ClusterConsolidationState

func (c *Cluster) ClusterConsolidationState() int64

ClusterConsolidationState returns a number representing the state of the cluster with respect to consolidation. If consolidation can't occur and this number hasn't changed, there is no point in re-attempting consolidation. This allows reducing overall CPU utilization by pausing consolidation when the cluster is in a static state.

func (*Cluster) ForEachNode

func (c *Cluster) ForEachNode(f func(n *Node) bool)

ForEachNode calls the supplied function once per node object that is being tracked. It is not safe to store the state.Node object, it should be only accessed from within the function provided to this method.

func (*Cluster) ForPodsWithAntiAffinity

func (c *Cluster) ForPodsWithAntiAffinity(fn func(p *v1.Pod, n *v1.Node) bool)

ForPodsWithAntiAffinity calls the supplied function once for each pod with required anti affinity terms that is currently bound to a node. The pod returned may not be up-to-date with respect to status, however since the anti-affinity terms can't be modified, they will be correct.

func (*Cluster) IsNodeNominated

func (c *Cluster) IsNodeNominated(nodeName string) bool

IsNodeNominated returns true if the given node was expected to have a pod bound to it during a recent scheduling batch

func (*Cluster) LastNodeCreationTime

func (c *Cluster) LastNodeCreationTime() time.Time

LastNodeCreationTime returns the last time that at a node was created.

func (*Cluster) LastNodeDeletionTime

func (c *Cluster) LastNodeDeletionTime() time.Time

LastNodeDeletionTime returns the last time that at a node was marked for deletion.

func (*Cluster) LivenessProbe

func (c *Cluster) LivenessProbe(req *http.Request) error

func (*Cluster) MarkForDeletion

func (c *Cluster) MarkForDeletion(nodeName string)

MarkForDeletion marks the node as pending deletion in the internal cluster state

func (*Cluster) NominateNodeForPod

func (c *Cluster) NominateNodeForPod(nodeName string)

NominateNodeForPod records that a node was the target of a pending pod during a scheduling batch

func (*Cluster) Synchronized

func (c *Cluster) Synchronized(ctx context.Context) error

Synchronized ensures that our cluster state is aware of at least all of the nodes that our list cache has. Since we launch nodes in parallel, we can create many node objects which may not all be reconciled by the cluster state before we start trying to schedule again. In this case, we would over-provision as we weren't aware of the inflight nodes.

func (*Cluster) UnmarkForDeletion

func (c *Cluster) UnmarkForDeletion(nodeName string)

UnmarkForDeletion removes the marking on the node as a node the controller intends to delete

type Node

type Node struct {
	Node *v1.Node
	// Capacity is the total resources on the node.
	Capacity v1.ResourceList
	// Allocatable is the total amount of resources on the node after os overhead.
	Allocatable v1.ResourceList
	// Available is allocatable minus anything allocated to pods.
	Available v1.ResourceList
	// Available is the total amount of resources that are available on the node.  This is the Allocatable minus the
	// resources requested by all pods bound to the node.
	// DaemonSetRequested is the total amount of resources that have been requested by daemon sets.  This allows users
	// of the Node to identify the remaining resources that we expect future daemonsets to consume.  This is already
	// included in the calculation for Available.
	DaemonSetRequested v1.ResourceList
	DaemonSetLimits    v1.ResourceList
	// HostPort usage of all pods that are bound to the node
	HostPortUsage *scheduling.HostPortUsage
	VolumeUsage   *scheduling.VolumeLimits
	VolumeLimits  scheduling.VolumeCount

	// PodTotalRequests is the total resources on pods scheduled to this node
	PodTotalRequests v1.ResourceList
	// PodTotalLimits is the total resource limits scheduled to this node
	PodTotalLimits v1.ResourceList
	// MarkedForDeletion marks this node to say that there is some controller that is
	// planning to delete this node so consider pods that are present on it available for scheduling
	MarkedForDeletion bool
	// contains filtered or unexported fields
}

Node is a cached version of a node in the cluster that maintains state which is expensive to compute every time it's needed. This currently contains node utilization across all the allocatable resources, but will soon be used to compute topology information. +k8s:deepcopy-gen=true

func (*Node) DeepCopy

func (in *Node) DeepCopy() *Node

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Node.

func (*Node) DeepCopyInto

func (in *Node) DeepCopyInto(out *Node)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type NodeController

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

NodeController reconciles nodes for the purpose of maintaining state regarding nodes that is expensive to compute.

func NewNodeController

func NewNodeController(kubeClient client.Client, cluster *Cluster) *NodeController

NewNodeController constructs a controller instance

func (*NodeController) LivenessProbe

func (c *NodeController) LivenessProbe(req *http.Request) error

func (*NodeController) Reconcile

func (c *NodeController) Reconcile(ctx context.Context, req reconcile.Request) (reconcile.Result, error)

func (*NodeController) Register

func (c *NodeController) Register(ctx context.Context, m manager.Manager) error

type PodController

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

PodController reconciles pods for the purpose of maintaining state regarding pods that is expensive to compute.

func NewPodController

func NewPodController(kubeClient client.Client, cluster *Cluster) *PodController

func (*PodController) Reconcile

func (c *PodController) Reconcile(ctx context.Context, req reconcile.Request) (reconcile.Result, error)

func (*PodController) Register

func (c *PodController) Register(ctx context.Context, m manager.Manager) error

type ProvisionerController

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

ProvisionerController reconciles provisioners to re-trigger consolidation on change.

func NewProvisionerController

func NewProvisionerController(kubeClient client.Client, cluster *Cluster) *ProvisionerController

func (*ProvisionerController) Reconcile

func (c *ProvisionerController) Reconcile(ctx context.Context, req reconcile.Request) (reconcile.Result, error)

func (*ProvisionerController) Register

func (c *ProvisionerController) Register(ctx context.Context, m manager.Manager) error