util

Documentation

Index

• Constants
• func BuildArgumentListFromMap(baseArguments map[string]string, overrideArguments map[string]string) []string
• func CheckErr(err error)
• func GetMasterEndpoint(cfg *kubeadmapi.MasterConfiguration) (string, error)
• func GetMasterHostPort(cfg *kubeadmapi.MasterConfiguration) (string, error)
• func KubernetesIsCIVersion(version string) bool
• func KubernetesReleaseVersion(version string) (string, error)
• func KubernetesVersionToImageTag(version string) string
• func ParseArgumentListToMap(arguments []string) map[string]string
• func ParseTemplate(strtmpl string, obj interface{}) ([]byte, error)
• func ReplaceArgument(command []string, argMutateFunc func(map[string]string) map[string]string) []string

Constants

const (
	DefaultErrorExitCode = 1
	PreFlightExitCode    = 2
	ValidationExitCode   = 3
)

Functions

func BuildArgumentListFromMap

func BuildArgumentListFromMap(baseArguments map[string]string, overrideArguments map[string]string) []string

BuildArgumentListFromMap takes two string-string maps, one with the base arguments and one with optional override arguments

func CheckErr

func CheckErr(err error)

CheckErr prints a user friendly error to STDERR and exits with a non-zero exit code. Unrecognized errors will be printed with an "error: " prefix.

This method is generic to the command in use and may be used by non-Kubectl commands.

func GetMasterEndpoint

func GetMasterEndpoint(cfg *kubeadmapi.MasterConfiguration) (string, error)

GetMasterEndpoint returns a properly formatted Master Endpoint or passes the error from GetMasterHostPort.

func GetMasterHostPort

func GetMasterHostPort(cfg *kubeadmapi.MasterConfiguration) (string, error)

GetMasterHostPort returns a properly formatted Master IP/port pair or error if the IP address can not be parsed or port is outside the valid TCP range.

func KubernetesIsCIVersion

func KubernetesIsCIVersion(version string) bool

KubernetesIsCIVersion checks if user requested CI version

func KubernetesReleaseVersion

func KubernetesReleaseVersion(version string) (string, error)

KubernetesReleaseVersion is helper function that can fetch available version information from release servers based on label names, like "stable" or "latest".

If argument is already semantic version string, it will return same string.

In case of labels, it tries to fetch from release servers and then return actual semantic version.

Available names on release servers:

stable      (latest stable release)
stable-1    (latest stable release in 1.x)
stable-1.0  (and similarly 1.1, 1.2, 1.3, ...)
latest      (latest release, including alpha/beta)
latest-1    (latest release in 1.x, including alpha/beta)
latest-1.0  (and similarly 1.1, 1.2, 1.3, ...)

func KubernetesVersionToImageTag

func KubernetesVersionToImageTag(version string) string

KubernetesVersionToImageTag is helper function that replaces all non-allowed symbols in tag strings with underscores. Image tag can only contain lowercase and uppercase letters, digits, underscores, periods and dashes. Current usage is for CI images where all of symbols except '+' are valid, but function is for generic usage where input can't be always pre-validated.

func ParseArgumentListToMap

func ParseArgumentListToMap(arguments []string) map[string]string

ParseArgumentListToMap parses a CLI argument list in the form "--foo=bar" to a string-string map

func ParseTemplate

func ParseTemplate(strtmpl string, obj interface{}) ([]byte, error)

func ReplaceArgument

func ReplaceArgument(command []string, argMutateFunc func(map[string]string) map[string]string) []string

ReplaceArgument gets a command list; converts it to a map for easier modification, runs the provided function that returns a new modified map, and then converts the map back to a command string slice