v1.29.2 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Feb 14, 2024 License: Apache-2.0 Imports: 9 Imported by: 1,182



Package types contains common types in the Kubelet.



View Source
const (
	// ResolvConfDefault is the system default DNS resolver configuration.
	ResolvConfDefault = "/etc/resolv.conf"
	// RFC3339NanoFixed is the fixed width version of time.RFC3339Nano.
	RFC3339NanoFixed = "2006-01-02T15:04:05.000000000Z07:00"
	// RFC3339NanoLenient is the variable width RFC3339 time format for lenient parsing of strings into timestamps.
	RFC3339NanoLenient = "2006-01-02T15:04:05.999999999Z07:00"
View Source
const (
	NodeAllocatableEnforcementKey = "pods"
	SystemReservedEnforcementKey  = "system-reserved"
	KubeReservedEnforcementKey    = "kube-reserved"
	NodeAllocatableNoneKey        = "none"

User visible keys for managing node allocatable enforcement on the node.

View Source
const (
	LimitedSwap   = "LimitedSwap"
	UnlimitedSwap = "UnlimitedSwap"

SwapBehavior types

View Source
const (
	ConfigSourceAnnotationKey    = "kubernetes.io/config.source"
	ConfigMirrorAnnotationKey    = v1.MirrorPodAnnotationKey
	ConfigFirstSeenAnnotationKey = "kubernetes.io/config.seen"
	ConfigHashAnnotationKey      = "kubernetes.io/config.hash"

Annotation keys for annotations used in this package.

View Source
const (
	// Filesource idenitified updates from a file.
	FileSource = "file"
	// HTTPSource identifies updates from querying a web page.
	HTTPSource = "http"
	// ApiserverSource identifies updates from Kubernetes API Server.
	ApiserverSource = "api"
	// AllSource identifies updates from all sources.
	AllSource = "*"

These constants identify the sources of pods.

View Source
const NamespaceDefault = metav1.NamespaceDefault

NamespaceDefault is a string representing the default namespace.


PodConditionsByKubelet is the list of pod conditions owned by kubelet


func GetPodSource added in v1.2.0

func GetPodSource(pod *v1.Pod) (string, error)

GetPodSource returns the source of the pod based on the annotation.

func GetValidatedSources added in v1.2.0

func GetValidatedSources(sources []string) ([]string, error)

GetValidatedSources gets all validated sources from the specified sources.

func IsCriticalPod added in v1.4.8

func IsCriticalPod(pod *v1.Pod) bool

IsCriticalPod returns true if pod's priority is greater than or equal to SystemCriticalPriority.

func IsCriticalPodBasedOnPriority added in v1.10.0

func IsCriticalPodBasedOnPriority(priority int32) bool

IsCriticalPodBasedOnPriority checks if the given pod is a critical pod based on priority resolved from pod Spec.

func IsMirrorPod added in v1.17.0

func IsMirrorPod(pod *v1.Pod) bool

IsMirrorPod returns true if the passed Pod is a Mirror Pod.

func IsNodeCriticalPod added in v1.22.0

func IsNodeCriticalPod(pod *v1.Pod) bool

IsNodeCriticalPod checks if the given pod is a system-node-critical

func IsRestartableInitContainer added in v1.28.0

func IsRestartableInitContainer(initContainer *v1.Container) bool

IsRestartableInitContainer returns true if the initContainer has ContainerRestartPolicyAlways.

func IsStaticPod added in v1.16.0

func IsStaticPod(pod *v1.Pod) bool

IsStaticPod returns true if the pod is a static pod.

func PodConditionByKubelet added in v1.11.0

func PodConditionByKubelet(conditionType v1.PodConditionType) bool

PodConditionByKubelet returns if the pod condition type is owned by kubelet

func PodConditionSharedByKubelet added in v1.26.0

func PodConditionSharedByKubelet(conditionType v1.PodConditionType) bool

PodConditionSharedByKubelet returns if the pod condition type is shared by kubelet

func Preemptable added in v1.12.0

func Preemptable(preemptor, preemptee *v1.Pod) bool

Preemptable returns true if preemptor pod can preempt preemptee pod if preemptee is not critical or if preemptor's priority is greater than preemptee's priority

func SortInitContainerStatuses added in v1.3.0

func SortInitContainerStatuses(p *v1.Pod, statuses []v1.ContainerStatus)

SortInitContainerStatuses ensures that statuses are in the order that their init container appears in the pod spec

func SortStatusesOfInitContainers added in v1.19.0

func SortStatusesOfInitContainers(p *v1.Pod, statusMap map[string]*v1.ContainerStatus) []v1.ContainerStatus

SortStatusesOfInitContainers returns the statuses of InitContainers of pod p, in the order that they appear in its spec.


type HTTPDoer added in v1.26.0

type HTTPDoer interface {
	Do(req *http.Request) (*http.Response, error)

HTTPDoer encapsulates http.Do functionality

type MirrorPodUID added in v1.8.0

type MirrorPodUID types.UID

MirrorPodUID is a pod UID for a mirror pod.

type PodOperation added in v1.2.0

type PodOperation int

PodOperation defines what changes will be made on a pod configuration.

const (
	// SET is the current pod configuration.
	SET PodOperation = iota
	// ADD signifies pods that are new to this source.
	// DELETE signifies pods that are gracefully deleted from this source.
	// REMOVE signifies pods that have been removed from this source.
	// UPDATE signifies pods have been updated in this source.
	// RECONCILE signifies pods that have unexpected status in this source,
	// kubelet should reconcile status with this source.

These constants identify the PodOperations that can be made on a pod configuration.

type PodUpdate added in v1.2.0

type PodUpdate struct {
	Pods   []*v1.Pod
	Op     PodOperation
	Source string

PodUpdate defines an operation sent on the channel. You can add or remove single services by sending an array of size one and Op == ADD|REMOVE (with REMOVE, only the ID is required). For setting the state of the system to a given state for this source configuration, set Pods as desired and Op to SET, which will reset the system state to that specified in this operation for this source channel. To remove all pods, set Pods to empty object and Op to SET.

Additionally, Pods should never be nil - it should always point to an empty slice. While functionally similar, this helps our unit tests properly check that the correct PodUpdates are generated.

type Reservation added in v1.2.0

type Reservation struct {
	// System represents resources reserved for non-kubernetes components.
	System v1.ResourceList
	// Kubernetes represents resources reserved for kubernetes system components.
	Kubernetes v1.ResourceList

Reservation represents reserved resources for non-pod components.

type ResolvedPodUID added in v1.8.0

type ResolvedPodUID types.UID

ResolvedPodUID is a pod UID which has been translated/resolved to the representation known to kubelets.

type SortedContainerStatuses added in v0.20.0

type SortedContainerStatuses []v1.ContainerStatus

SortedContainerStatuses is a type to help sort container statuses based on container names.

func (SortedContainerStatuses) Len added in v0.20.0

func (s SortedContainerStatuses) Len() int

func (SortedContainerStatuses) Less added in v0.20.0

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

func (SortedContainerStatuses) Swap added in v0.20.0

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

type SyncPodType added in v1.2.0

type SyncPodType int

SyncPodType classifies pod updates, eg: create, update.

const (
	// SyncPodSync is when the pod is synced to ensure desired state
	SyncPodSync SyncPodType = iota
	// SyncPodUpdate is when the pod is updated from source
	// SyncPodCreate is when the pod is created from source
	// SyncPodKill is when the pod should have no running containers. A pod stopped in this way could be
	// restarted in the future due config changes.

func (SyncPodType) String added in v1.2.0

func (sp SyncPodType) String() string

type Timestamp added in v0.20.0

type Timestamp struct {
	// contains filtered or unexported fields

Timestamp wraps around time.Time and offers utilities to format and parse the time using RFC3339Nano

func ConvertToTimestamp added in v0.20.0

func ConvertToTimestamp(timeString string) *Timestamp

ConvertToTimestamp takes a string, parses it using the RFC3339NanoLenient layout, and converts it to a Timestamp object.

func NewTimestamp added in v0.20.0

func NewTimestamp() *Timestamp

NewTimestamp returns a Timestamp object using the current time.

func (*Timestamp) Get added in v0.20.0

func (t *Timestamp) Get() time.Time

Get returns the time as time.Time.

func (*Timestamp) GetString added in v0.20.0

func (t *Timestamp) GetString() string

GetString returns the time in the string format using the RFC3339NanoFixed layout.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL