package kubelet

import "k8s.io/kubernetes/pkg/kubelet"

Package kubelet is the package that contains the libraries that drive the Kubelet binary. The kubelet is responsible for node level pod management. It runs on each worker in the cluster.

Index ¶

• Constants
• func GetPhase(spec *api.PodSpec, info []api.ContainerStatus) api.PodPhase
• type DiskSpacePolicy
• type FlannelHelper
• func NewFlannelHelper() *FlannelHelper
• func (f *FlannelHelper) Handshake() (podCIDR string, err error)
• type ImageGCPolicy
• type Kubelet
• func NewMainKubelet( hostname string, nodeName string, dockerClient dockertools.DockerInterface, kubeClient client.Interface, rootDirectory string, podInfraContainerImage string, resyncInterval time.Duration, pullQPS float32, pullBurst int, eventQPS float32, eventBurst int, containerGCPolicy kubecontainer.ContainerGCPolicy, sourcesReady SourcesReadyFn, registerNode bool, registerSchedulable bool, standaloneMode bool, clusterDomain string, clusterDNS net.IP, masterServiceNamespace string, volumePlugins []volume.VolumePlugin, networkPlugins []network.NetworkPlugin, networkPluginName string, streamingConnectionIdleTimeout time.Duration, recorder record.EventRecorder, cadvisorInterface cadvisor.Interface, imageGCPolicy ImageGCPolicy, diskSpacePolicy DiskSpacePolicy, cloud cloudprovider.Interface, nodeLabels string, nodeStatusUpdateFrequency time.Duration, resourceContainer string, osInterface kubecontainer.OSInterface, cgroupRoot string, containerRuntime string, rktPath string, rktStage1Image string, mounter mount.Interface, writer kubeio.Writer, chownRunner chown.Interface, chmodRunner chmod.Interface, dockerDaemonContainer string, systemContainer string, configureCBR0 bool, podCIDR string, reconcileCIDR bool, maxPods int, dockerExecHandler dockertools.ExecHandler, resolverConfig string, cpuCFSQuota bool, daemonEndpoints *api.NodeDaemonEndpoints, oomAdjuster *oom.OOMAdjuster, serializeImagePulls bool, containerManager cm.ContainerManager, outOfDiskTransitionFrequency time.Duration, flannelExperimentalOverlay bool, nodeIP net.IP, reservation kubetypes.Reservation, ) (*Kubelet, error)
• func (kl *Kubelet) AttachContainer(podFullName string, podUID types.UID, containerName string, stdin io.Reader, stdout, stderr io.WriteCloser, tty bool) error
• func (kl *Kubelet) BirthCry()
• func (kl *Kubelet) ExecInContainer(podFullName string, podUID types.UID, containerName string, cmd []string, stdin io.Reader, stdout, stderr io.WriteCloser, tty bool) error
• func (kl *Kubelet) GenerateRunContainerOptions(pod *api.Pod, container *api.Container) (*kubecontainer.RunContainerOptions, error)
• func (kl *Kubelet) GetCachedMachineInfo() (*cadvisorapi.MachineInfo, error)
• func (kl *Kubelet) GetContainerInfo(podFullName string, podUID types.UID, containerName string, req *cadvisorapi.ContainerInfoRequest) (*cadvisorapi.ContainerInfo, error)
• func (kl *Kubelet) GetContainerRuntimeVersion() (kubecontainer.Version, error)
• func (kl *Kubelet) GetHostIP() (net.IP, error)
• func (kl *Kubelet) GetHostname() string
• func (kl *Kubelet) GetKubeletContainerLogs(podFullName, containerName string, logOptions *api.PodLogOptions, stdout, stderr io.Writer) error
• func (kl *Kubelet) GetNode() (*api.Node, error)
• func (kl *Kubelet) GetPodByFullName(podFullName string) (*api.Pod, bool)
• func (kl *Kubelet) GetPodByName(namespace, name string) (*api.Pod, bool)
• func (kl *Kubelet) GetPods() []*api.Pod
• func (kl *Kubelet) GetRawContainerInfo(containerName string, req *cadvisorapi.ContainerInfoRequest, subcontainers bool) (map[string]*cadvisorapi.ContainerInfo, error)
• func (kl *Kubelet) GetRunningPods() ([]*api.Pod, error)
• func (kl *Kubelet) GetRuntime() kubecontainer.Runtime
• func (kl *Kubelet) HandlePodAdditions(pods []*api.Pod)
• func (kl *Kubelet) HandlePodCleanups() error
• func (kl *Kubelet) HandlePodDeletions(pods []*api.Pod)
• func (kl *Kubelet) HandlePodReconcile(pods []*api.Pod)
• func (kl *Kubelet) HandlePodSyncs(pods []*api.Pod)
• func (kl *Kubelet) HandlePodUpdates(pods []*api.Pod)
• func (kl *Kubelet) LatestLoopEntryTime() time.Time
• func (kl *Kubelet) ListenAndServe(address net.IP, port uint, tlsOptions *server.TLSOptions, auth server.AuthInterface, enableDebuggingHandlers bool)
• func (kl *Kubelet) ListenAndServeReadOnly(address net.IP, port uint)
• func (kl *Kubelet) PortForward(podFullName string, podUID types.UID, port uint16, stream io.ReadWriteCloser) error
• func (kl *Kubelet) ResyncInterval() time.Duration
• func (kl *Kubelet) Run(updates <-chan kubetypes.PodUpdate)
• func (kl *Kubelet) RunInContainer(podFullName string, podUID types.UID, containerName string, cmd []string) ([]byte, error)
• func (kl *Kubelet) RunOnce(updates <-chan kubetypes.PodUpdate) ([]RunPodResult, error)
• func (kl *Kubelet) ServeLogs(w http.ResponseWriter, req *http.Request)
• func (kl *Kubelet) StartGarbageCollection()
• func (kl *Kubelet) StreamingConnectionIdleTimeout() time.Duration
• type OOMWatcher
• func NewOOMWatcher(cadvisor cadvisor.Interface, recorder record.EventRecorder) OOMWatcher
• type PodWorkers
• type RunPodResult
• type SourcesReadyFn
• type SyncHandler
• type TestingInterface

Constants ¶

const (

	// max backoff period, exported for the e2e test
	MaxContainerBackOff = 300 * time.Second
)

Functions ¶

func GetPhase ¶

func GetPhase(spec *api.PodSpec, info []api.ContainerStatus) api.PodPhase

GetPhase returns the phase of a pod given its container info. This func is exported to simplify integration with 3rd party kubelet integrations like kubernetes-mesos.

Types ¶

type DiskSpacePolicy ¶

type DiskSpacePolicy struct {
	// free disk space threshold for filesystem holding docker images.
	DockerFreeDiskMB int
	// free disk space threshold for root filesystem. Host volumes are created on root fs.
	RootFreeDiskMB int
}

type FlannelHelper ¶

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

A Kubelet to flannel bridging helper.

func NewFlannelHelper ¶

func NewFlannelHelper() *FlannelHelper

NewFlannelHelper creates a new flannel helper.

func (*FlannelHelper) Handshake ¶

func (f *FlannelHelper) Handshake() (podCIDR string, err error)

Handshake waits for the flannel subnet file and installs a few IPTables rules, returning the pod CIDR allocated for this node.

type ImageGCPolicy ¶

type ImageGCPolicy struct {
	// Any usage above this threshold will always trigger garbage collection.
	// This is the highest usage we will allow.
	HighThresholdPercent int

	// Any usage below this threshold will never trigger garbage collection.
	// This is the lowest threshold we will try to garbage collect to.
	LowThresholdPercent int
}

A policy for garbage collecting images. Policy defines an allowed band in which garbage collection will be run.

type Kubelet ¶

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

Kubelet is the main kubelet implementation.

func NewMainKubelet ¶

func NewMainKubelet(
	hostname string,
	nodeName string,
	dockerClient dockertools.DockerInterface,
	kubeClient client.Interface,
	rootDirectory string,
	podInfraContainerImage string,
	resyncInterval time.Duration,
	pullQPS float32,
	pullBurst int,
	eventQPS float32,
	eventBurst int,
	containerGCPolicy kubecontainer.ContainerGCPolicy,
	sourcesReady SourcesReadyFn,
	registerNode bool,
	registerSchedulable bool,
	standaloneMode bool,
	clusterDomain string,
	clusterDNS net.IP,
	masterServiceNamespace string,
	volumePlugins []volume.VolumePlugin,
	networkPlugins []network.NetworkPlugin,
	networkPluginName string,
	streamingConnectionIdleTimeout time.Duration,
	recorder record.EventRecorder,
	cadvisorInterface cadvisor.Interface,
	imageGCPolicy ImageGCPolicy,
	diskSpacePolicy DiskSpacePolicy,
	cloud cloudprovider.Interface,
	nodeLabels string,
	nodeStatusUpdateFrequency time.Duration,
	resourceContainer string,
	osInterface kubecontainer.OSInterface,
	cgroupRoot string,
	containerRuntime string,
	rktPath string,
	rktStage1Image string,
	mounter mount.Interface,
	writer kubeio.Writer,
	chownRunner chown.Interface,
	chmodRunner chmod.Interface,
	dockerDaemonContainer string,
	systemContainer string,
	configureCBR0 bool,
	podCIDR string,
	reconcileCIDR bool,
	maxPods int,
	dockerExecHandler dockertools.ExecHandler,
	resolverConfig string,
	cpuCFSQuota bool,
	daemonEndpoints *api.NodeDaemonEndpoints,
	oomAdjuster *oom.OOMAdjuster,
	serializeImagePulls bool,
	containerManager cm.ContainerManager,
	outOfDiskTransitionFrequency time.Duration,
	flannelExperimentalOverlay bool,
	nodeIP net.IP,
	reservation kubetypes.Reservation,
) (*Kubelet, error)

New instantiates a new Kubelet object along with all the required internal modules. No initialization of Kubelet and its modules should happen here.

func (*Kubelet) AttachContainer ¶

func (kl *Kubelet) AttachContainer(podFullName string, podUID types.UID, containerName string, stdin io.Reader, stdout, stderr io.WriteCloser, tty bool) error

func (*Kubelet) BirthCry ¶

func (kl *Kubelet) BirthCry()

BirthCry sends an event that the kubelet has started up.

func (*Kubelet) ExecInContainer ¶

func (kl *Kubelet) ExecInContainer(podFullName string, podUID types.UID, containerName string, cmd []string, stdin io.Reader, stdout, stderr io.WriteCloser, tty bool) error

ExecInContainer executes a command in a container, connecting the supplied stdin/stdout/stderr to the command's IO streams.

func (*Kubelet) GenerateRunContainerOptions ¶

func (kl *Kubelet) GenerateRunContainerOptions(pod *api.Pod, container *api.Container) (*kubecontainer.RunContainerOptions, error)

GenerateRunContainerOptions generates the RunContainerOptions, which can be used by the container runtime to set parameters for launching a container.

func (*Kubelet) GetCachedMachineInfo ¶

func (kl *Kubelet) GetCachedMachineInfo() (*cadvisorapi.MachineInfo, error)

GetCachedMachineInfo assumes that the machine info can't change without a reboot

func (*Kubelet) GetContainerInfo ¶

func (kl *Kubelet) GetContainerInfo(podFullName string, podUID types.UID, containerName string, req *cadvisorapi.ContainerInfoRequest) (*cadvisorapi.ContainerInfo, error)

GetContainerInfo returns stats (from Cadvisor) for a container.

func (*Kubelet) GetContainerRuntimeVersion ¶

func (kl *Kubelet) GetContainerRuntimeVersion() (kubecontainer.Version, error)

Returns the container runtime version for this Kubelet.

func (*Kubelet) GetHostIP ¶

func (kl *Kubelet) GetHostIP() (net.IP, error)

Returns host IP or nil in case of error.

func (*Kubelet) GetHostname ¶

func (kl *Kubelet) GetHostname() string

GetHostname Returns the hostname as the kubelet sees it.

func (*Kubelet) GetKubeletContainerLogs ¶

func (kl *Kubelet) GetKubeletContainerLogs(podFullName, containerName string, logOptions *api.PodLogOptions, stdout, stderr io.Writer) error

GetKubeletContainerLogs returns logs from the container TODO: this method is returning logs of random container attempts, when it should be returning the most recent attempt or all of them.

func (*Kubelet) GetNode ¶

func (kl *Kubelet) GetNode() (*api.Node, error)

func (*Kubelet) GetPodByFullName ¶

func (kl *Kubelet) GetPodByFullName(podFullName string) (*api.Pod, bool)

func (*Kubelet) GetPodByName ¶

func (kl *Kubelet) GetPodByName(namespace, name string) (*api.Pod, bool)

GetPodByName provides the first pod that matches namespace and name, as well as whether the pod was found.

func (*Kubelet) GetPods ¶

func (kl *Kubelet) GetPods() []*api.Pod

GetPods returns all pods bound to the kubelet and their spec, and the mirror pods.

func (*Kubelet) GetRawContainerInfo ¶

func (kl *Kubelet) GetRawContainerInfo(containerName string, req *cadvisorapi.ContainerInfoRequest, subcontainers bool) (map[string]*cadvisorapi.ContainerInfo, error)

Returns stats (from Cadvisor) for a non-Kubernetes container.

func (*Kubelet) GetRunningPods ¶

func (kl *Kubelet) GetRunningPods() ([]*api.Pod, error)

GetRunningPods returns all pods running on kubelet from looking at the container runtime cache. This function converts kubecontainer.Pod to api.Pod, so only the fields that exist in both kubecontainer.Pod and api.Pod are considered meaningful.

func (*Kubelet) GetRuntime ¶

func (kl *Kubelet) GetRuntime() kubecontainer.Runtime

GetRuntime returns the current Runtime implementation in use by the kubelet. This func is exported to simplify integration with third party kubelet extensions (e.g. kubernetes-mesos).

func (*Kubelet) HandlePodAdditions ¶

func (kl *Kubelet) HandlePodAdditions(pods []*api.Pod)

func (*Kubelet) HandlePodCleanups ¶

func (kl *Kubelet) HandlePodCleanups() error

HandlePodCleanups performs a series of cleanup work, including terminating pod workers, killing unwanted pods, and removing orphaned volumes/pod directories. TODO(yujuhong): This function is executed by the main sync loop, so it should not contain any blocking calls. Re-examine the function and decide whether or not we should move it into a separte goroutine.

func (*Kubelet) HandlePodDeletions ¶

func (kl *Kubelet) HandlePodDeletions(pods []*api.Pod)

func (*Kubelet) HandlePodReconcile ¶

func (kl *Kubelet) HandlePodReconcile(pods []*api.Pod)

func (*Kubelet) HandlePodSyncs ¶

func (kl *Kubelet) HandlePodSyncs(pods []*api.Pod)

func (*Kubelet) HandlePodUpdates ¶

func (kl *Kubelet) HandlePodUpdates(pods []*api.Pod)

func (*Kubelet) LatestLoopEntryTime ¶

func (kl *Kubelet) LatestLoopEntryTime() time.Time

func (*Kubelet) ListenAndServe ¶

func (kl *Kubelet) ListenAndServe(address net.IP, port uint, tlsOptions *server.TLSOptions, auth server.AuthInterface, enableDebuggingHandlers bool)

func (*Kubelet) ListenAndServeReadOnly ¶

func (kl *Kubelet) ListenAndServeReadOnly(address net.IP, port uint)

func (*Kubelet) PortForward ¶

func (kl *Kubelet) PortForward(podFullName string, podUID types.UID, port uint16, stream io.ReadWriteCloser) error

PortForward connects to the pod's port and copies data between the port and the stream.

func (*Kubelet) ResyncInterval ¶

func (kl *Kubelet) ResyncInterval() time.Duration

func (*Kubelet) Run ¶

func (kl *Kubelet) Run(updates <-chan kubetypes.PodUpdate)

Run starts the kubelet reacting to config updates

func (*Kubelet) RunInContainer ¶

func (kl *Kubelet) RunInContainer(podFullName string, podUID types.UID, containerName string, cmd []string) ([]byte, error)

Run a command in a container, returns the combined stdout, stderr as an array of bytes

func (*Kubelet) RunOnce ¶

func (kl *Kubelet) RunOnce(updates <-chan kubetypes.PodUpdate) ([]RunPodResult, error)

RunOnce polls from one configuration update and run the associated pods.

func (*Kubelet) ServeLogs ¶

func (kl *Kubelet) ServeLogs(w http.ResponseWriter, req *http.Request)

Returns logs of current machine.

func (*Kubelet) StartGarbageCollection ¶

func (kl *Kubelet) StartGarbageCollection()

Starts garbage collection threads.

func (*Kubelet) StreamingConnectionIdleTimeout ¶

func (kl *Kubelet) StreamingConnectionIdleTimeout() time.Duration

type OOMWatcher ¶

type OOMWatcher interface {
	Start(ref *api.ObjectReference) error
}

func NewOOMWatcher ¶

func NewOOMWatcher(cadvisor cadvisor.Interface, recorder record.EventRecorder) OOMWatcher

type PodWorkers ¶

type PodWorkers interface {
	UpdatePod(pod *api.Pod, mirrorPod *api.Pod, updateType kubetypes.SyncPodType, updateComplete func())
	ForgetNonExistingPodWorkers(desiredPods map[types.UID]empty)
	ForgetWorker(uid types.UID)
}

PodWorkers is an abstract interface for testability.

type RunPodResult ¶

type RunPodResult struct {
	Pod *api.Pod
	Err error
}

type SourcesReadyFn ¶

type SourcesReadyFn func(sourcesSeen sets.String) bool

type SyncHandler ¶

type SyncHandler interface {
	HandlePodAdditions(pods []*api.Pod)
	HandlePodUpdates(pods []*api.Pod)
	HandlePodDeletions(pods []*api.Pod)
	HandlePodReconcile(pods []*api.Pod)
	HandlePodSyncs(pods []*api.Pod)
	HandlePodCleanups() error
}

SyncHandler is an interface implemented by Kubelet, for testability

type TestingInterface ¶

type TestingInterface interface {
	Errorf(format string, args ...interface{})
}

Source Files ¶

container_bridge.go disk_manager.go doc.go fake_pod_workers.go flannel_helper.go image_manager.go kubelet.go networks.go oom_watcher.go pod_workers.go root_context_linux.go runonce.go runtime.go util.go volume_manager.go volumes.go volumes_linux.go

Directories ¶