helper

Documentation

Index

• Variables
• func AddOrUpdateTolerationInPod(pod *core.Pod, toleration *core.Toleration) bool
• func AddToNodeAddresses(addresses *[]core.NodeAddress, addAddresses ...core.NodeAddress)
• func GetAccessModesAsString(modes []core.PersistentVolumeAccessMode) string
• func GetAccessModesFromString(modes string) []core.PersistentVolumeAccessMode
• func GetPersistentVolumeClaimClass(claim *core.PersistentVolumeClaim) string
• func GetPersistentVolumeClass(volume *core.PersistentVolume) string
• func GetStorageNodeAffinityFromAnnotation(annotations map[string]string) (*core.NodeAffinity, error)
• func GetTaintsFromNodeAnnotations(annotations map[string]string) ([]core.Taint, error)
• func GetTolerationsFromPodAnnotations(annotations map[string]string) ([]core.Toleration, error)
• func HasAnnotation(obj core.ObjectMeta, ann string) bool
• func HugePageResourceName(pageSize resource.Quantity) core.ResourceName
• func HugePageSizeFromResourceName(name core.ResourceName) (resource.Quantity, error)
• func IsDefaultNamespaceResource(name core.ResourceName) bool
• func IsExtendedResourceName(name core.ResourceName) bool
• func IsHugePageResourceName(name core.ResourceName) bool
• func IsIntegerResourceName(str string) bool
• func IsOvercommitAllowed(name core.ResourceName) bool
• func IsQuotaHugePageResourceName(name core.ResourceName) bool
• func IsResourceQuotaScopeValidForResource(scope core.ResourceQuotaScope, resource string) bool
• func IsScalarResourceName(name core.ResourceName) bool
• func IsServiceIPRequested(service *core.Service) bool
• func IsServiceIPSet(service *core.Service) bool
• func IsStandardContainerResourceName(str string) bool
• func IsStandardFinalizerName(str string) bool
• func IsStandardLimitRangeType(str string) bool
• func IsStandardQuotaResourceName(str string) bool
• func IsStandardResourceName(str string) bool
• func IsStandardResourceQuotaScope(str string) bool
• func LoadBalancerStatusDeepCopy(lb *core.LoadBalancerStatus) *core.LoadBalancerStatus
• func LoadBalancerStatusEqual(l, r *core.LoadBalancerStatus) bool
• func NodeSelectorRequirementsAsSelector(nsm []core.NodeSelectorRequirement) (labels.Selector, error)
• func NonConvertibleFields(annotations map[string]string) map[string]string
• func PersistentVolumeClaimHasClass(claim *core.PersistentVolumeClaim) bool
• func PodAnnotationsFromSysctls(sysctls []core.Sysctl) string
• func SetMetaDataAnnotation(obj *core.ObjectMeta, ann string, value string)
• func StorageNodeAffinityToAlphaAnnotation(annotations map[string]string, affinity *core.NodeAffinity) error
• func SysctlsFromPodAnnotation(annotation string) ([]core.Sysctl, error)
• func SysctlsFromPodAnnotations(a map[string]string) ([]core.Sysctl, []core.Sysctl, error)
• func TaintToleratedByTolerations(taint *core.Taint, tolerations []core.Toleration) bool
• func TolerationToleratesTaint(toleration *core.Toleration, taint *core.Taint) bool

Variables

var Semantic = conversion.EqualitiesOrDie(
	func(a, b resource.Quantity) bool {

		return a.Cmp(b) == 0
	},
	func(a, b metav1.MicroTime) bool {
		return a.UTC() == b.UTC()
	},
	func(a, b metav1.Time) bool {
		return a.UTC() == b.UTC()
	},
	func(a, b labels.Selector) bool {
		return a.String() == b.String()
	},
	func(a, b fields.Selector) bool {
		return a.String() == b.String()
	},
)

Semantic can do semantic deep equality checks for core objects. Example: apiequality.Semantic.DeepEqual(aPod, aPodWithNonNilButEmptyMaps) == true

Functions

func AddOrUpdateTolerationInPod

func AddOrUpdateTolerationInPod(pod *core.Pod, toleration *core.Toleration) bool

AddOrUpdateTolerationInPod tries to add a toleration to the pod's toleration list. Returns true if something was updated, false otherwise.

func AddToNodeAddresses

func AddToNodeAddresses(addresses *[]core.NodeAddress, addAddresses ...core.NodeAddress)

AddToNodeAddresses appends the NodeAddresses to the passed-by-pointer slice, only if they do not already exist

func GetAccessModesAsString

func GetAccessModesAsString(modes []core.PersistentVolumeAccessMode) string

GetAccessModesAsString returns a string representation of an array of access modes. modes, when present, are always in the same order: RWO,ROX,RWX.

func GetAccessModesFromString

func GetAccessModesFromString(modes string) []core.PersistentVolumeAccessMode

GetAccessModesAsString returns an array of AccessModes from a string created by GetAccessModesAsString

func GetPersistentVolumeClaimClass

func GetPersistentVolumeClaimClass(claim *core.PersistentVolumeClaim) string

GetPersistentVolumeClaimClass returns StorageClassName. If no storage class was requested, it returns "".

func GetPersistentVolumeClass

func GetPersistentVolumeClass(volume *core.PersistentVolume) string

GetPersistentVolumeClass returns StorageClassName.

func GetStorageNodeAffinityFromAnnotation

func GetStorageNodeAffinityFromAnnotation(annotations map[string]string) (*core.NodeAffinity, error)

GetStorageNodeAffinityFromAnnotation gets the json serialized data from PersistentVolume.Annotations and converts it to the NodeAffinity type in core. TODO: update when storage node affinity graduates to beta

func GetTaintsFromNodeAnnotations

func GetTaintsFromNodeAnnotations(annotations map[string]string) ([]core.Taint, error)

GetTaintsFromNodeAnnotations gets the json serialized taints data from Pod.Annotations and converts it to the []Taint type in core.

func GetTolerationsFromPodAnnotations

func GetTolerationsFromPodAnnotations(annotations map[string]string) ([]core.Toleration, error)

GetTolerationsFromPodAnnotations gets the json serialized tolerations data from Pod.Annotations and converts it to the []Toleration type in core.

func HasAnnotation

func HasAnnotation(obj core.ObjectMeta, ann string) bool

HasAnnotation returns a bool if passed in annotation exists

func HugePageResourceName

func HugePageResourceName(pageSize resource.Quantity) core.ResourceName

HugePageResourceName returns a ResourceName with the canonical hugepage prefix prepended for the specified page size. The page size is converted to its canonical representation.

func HugePageSizeFromResourceName

func HugePageSizeFromResourceName(name core.ResourceName) (resource.Quantity, error)

HugePageSizeFromResourceName returns the page size for the specified huge page resource name. If the specified input is not a valid huge page resource name an error is returned.

func IsDefaultNamespaceResource

func IsDefaultNamespaceResource(name core.ResourceName) bool

IsDefaultNamespaceResource returns true if the resource name is in the *kubernetes.io/ namespace. Partially-qualified (unprefixed) names are implicitly in the kubernetes.io/ namespace.

func IsExtendedResourceName

func IsExtendedResourceName(name core.ResourceName) bool

IsExtendedResourceName returns true if the resource name is not in the default namespace.

func IsHugePageResourceName

func IsHugePageResourceName(name core.ResourceName) bool

IsHugePageResourceName returns true if the resource name has the huge page resource prefix.

func IsIntegerResourceName

func IsIntegerResourceName(str string) bool

IsIntegerResourceName returns true if the resource is measured in integer values

func IsOvercommitAllowed

func IsOvercommitAllowed(name core.ResourceName) bool

IsOvercommitAllowed returns true if the resource is in the default namespace and not blacklisted.

func IsQuotaHugePageResourceName

func IsQuotaHugePageResourceName(name core.ResourceName) bool

IsQuotaHugePageResourceName returns true if the resource name has the quota related huge page resource prefix.

func IsResourceQuotaScopeValidForResource

func IsResourceQuotaScopeValidForResource(scope core.ResourceQuotaScope, resource string) bool

IsResourceQuotaScopeValidForResource returns true if the resource applies to the specified scope

func IsScalarResourceName

func IsScalarResourceName(name core.ResourceName) bool

Extended and HugePages resources

func IsServiceIPRequested

func IsServiceIPRequested(service *core.Service) bool

this function aims to check if the service's cluster IP is requested or not

func IsServiceIPSet

func IsServiceIPSet(service *core.Service) bool

this function aims to check if the service's ClusterIP is set or not the objective is not to perform validation here

func IsStandardContainerResourceName

func IsStandardContainerResourceName(str string) bool

IsStandardContainerResourceName returns true if the container can make a resource request for the specified resource

func IsStandardFinalizerName

func IsStandardFinalizerName(str string) bool

func IsStandardLimitRangeType

func IsStandardLimitRangeType(str string) bool

IsStandardLimitRangeType returns true if the type is Pod or Container

func IsStandardQuotaResourceName

func IsStandardQuotaResourceName(str string) bool

IsStandardQuotaResourceName returns true if the resource is known to the quota tracking system

func IsStandardResourceName

func IsStandardResourceName(str string) bool

IsStandardResourceName returns true if the resource is known to the system

func IsStandardResourceQuotaScope

func IsStandardResourceQuotaScope(str string) bool

IsStandardResourceQuotaScope returns true if the scope is a standard value

func LoadBalancerStatusDeepCopy

func LoadBalancerStatusDeepCopy(lb *core.LoadBalancerStatus) *core.LoadBalancerStatus

TODO: make method on LoadBalancerStatus?

func LoadBalancerStatusEqual

func LoadBalancerStatusEqual(l, r *core.LoadBalancerStatus) bool

TODO: make method on LoadBalancerStatus?

func NodeSelectorRequirementsAsSelector

func NodeSelectorRequirementsAsSelector(nsm []core.NodeSelectorRequirement) (labels.Selector, error)

NodeSelectorRequirementsAsSelector converts the []NodeSelectorRequirement core type into a struct that implements labels.Selector.

func NonConvertibleFields

func NonConvertibleFields(annotations map[string]string) map[string]string

NonConvertibleFields iterates over the provided map and filters out all but any keys with the "non-convertible.kubernetes.io" prefix.

func PersistentVolumeClaimHasClass

func PersistentVolumeClaimHasClass(claim *core.PersistentVolumeClaim) bool

PersistentVolumeClaimHasClass returns true if given claim has set StorageClassName field.

func PodAnnotationsFromSysctls

func PodAnnotationsFromSysctls(sysctls []core.Sysctl) string

PodAnnotationsFromSysctls creates an annotation value for a slice of Sysctls.

func SetMetaDataAnnotation

func SetMetaDataAnnotation(obj *core.ObjectMeta, ann string, value string)

SetMetaDataAnnotation sets the annotation and value

func StorageNodeAffinityToAlphaAnnotation

func StorageNodeAffinityToAlphaAnnotation(annotations map[string]string, affinity *core.NodeAffinity) error

Converts NodeAffinity type to Alpha annotation for use in PersistentVolumes TODO: update when storage node affinity graduates to beta

func SysctlsFromPodAnnotation

func SysctlsFromPodAnnotation(annotation string) ([]core.Sysctl, error)

SysctlsFromPodAnnotation parses an annotation value into a slice of Sysctls.

func SysctlsFromPodAnnotations

func SysctlsFromPodAnnotations(a map[string]string) ([]core.Sysctl, []core.Sysctl, error)

SysctlsFromPodAnnotations parses the sysctl annotations into a slice of safe Sysctls and a slice of unsafe Sysctls. This is only a convenience wrapper around SysctlsFromPodAnnotation.

func TaintToleratedByTolerations

func TaintToleratedByTolerations(taint *core.Taint, tolerations []core.Toleration) bool

TaintToleratedByTolerations checks if taint is tolerated by any of the tolerations.

func TolerationToleratesTaint

func TolerationToleratesTaint(toleration *core.Toleration, taint *core.Taint) bool

TolerationToleratesTaint checks if the toleration tolerates the taint.