util

Documentation

Overview

Package util contains common functions that are used by the rest of the OpenShift build system.

Index

• Constants
• func BuildConfigBuilds(c buildlister.BuildLister, namespace, name string, filterFunc buildFilter) ([]*buildapi.Build, error)
• func BuildConfigSelector(name string) labels.Selector
• func BuildConfigSelectorDeprecated(name string) labels.Selector
• func BuildDeepCopy(build *buildapi.Build) (*buildapi.Build, error)
• func BuildNameForConfigVersion(name string, version int) string
• func BuildNumber(build *buildapi.Build) (int64, error)
• func BuildRunPolicy(build *buildapi.Build) buildapi.BuildRunPolicy
• func ConfigNameForBuild(build *buildapi.Build) string
• func CopyApiEnvVarToV1EnvVar(in []kapi.EnvVar) []v1.EnvVar
• func CopyApiResourcesToV1Resources(in *kapi.ResourceRequirements) v1.ResourceRequirements
• func GetBuildEnv(build *buildapi.Build) []kapi.EnvVar
• func GetBuildName(pod metav1.Object) string
• func GetInputReference(strategy buildapi.BuildStrategy) *kapi.ObjectReference
• func IsBuildComplete(build *buildapi.Build) bool
• func IsPaused(bc *buildapi.BuildConfig) bool
• func IsTerminalPhase(phase buildapi.BuildPhase) bool
• func MergeTrustedEnvWithoutDuplicates(source []v1.EnvVar, output *[]v1.EnvVar, sourcePrecedence bool)
• func SafeForLoggingBuild(build *buildapi.Build) *buildapi.Build
• func SafeForLoggingBuildCommonSpec(spec *buildapi.CommonSpec) *buildapi.CommonSpec
• func SafeForLoggingEnvVar(env []kapi.EnvVar) []kapi.EnvVar
• func SafeForLoggingEnvironmentList(env s2iapi.EnvironmentList) s2iapi.EnvironmentList
• func SafeForLoggingS2IConfig(config *s2iapi.Config) *s2iapi.Config
• func SafeForLoggingURL(u *url.URL) *url.URL
• func SetBuildEnv(build *buildapi.Build, env []kapi.EnvVar)
• func UpdateBuildEnv(build *buildapi.Build, env []kapi.EnvVar)
• func VersionForBuild(build *buildapi.Build) int

Constants

const (
	// NoBuildLogsMessage reports that no build logs are available
	NoBuildLogsMessage = "No logs are available."
)

Functions

func BuildConfigBuilds

func BuildConfigBuilds(c buildlister.BuildLister, namespace, name string, filterFunc buildFilter) ([]*buildapi.Build, error)

BuildConfigBuilds return a list of builds for the given build config. Optionally you can specify a filter function to select only builds that matches your criteria.

func BuildConfigSelector

func BuildConfigSelector(name string) labels.Selector

BuildConfigSelector returns a label Selector which can be used to find all builds for a BuildConfig.

func BuildConfigSelectorDeprecated

func BuildConfigSelectorDeprecated(name string) labels.Selector

BuildConfigSelectorDeprecated returns a label Selector which can be used to find all builds for a BuildConfig that use the deprecated labels.

func BuildDeepCopy

func BuildDeepCopy(build *buildapi.Build) (*buildapi.Build, error)

func BuildNameForConfigVersion

func BuildNameForConfigVersion(name string, version int) string

BuildNameForConfigVersion returns the name of the version-th build for the config that has the provided name.

func BuildNumber

func BuildNumber(build *buildapi.Build) (int64, error)

BuildNumber returns the given build number.

func BuildRunPolicy

func BuildRunPolicy(build *buildapi.Build) buildapi.BuildRunPolicy

BuildRunPolicy returns the scheduling policy for the build based on the "queued" label.

func ConfigNameForBuild

func ConfigNameForBuild(build *buildapi.Build) string

ConfigNameForBuild returns the name of the build config from a build name.

func CopyApiEnvVarToV1EnvVar

func CopyApiEnvVarToV1EnvVar(in []kapi.EnvVar) []v1.EnvVar

func CopyApiResourcesToV1Resources

func CopyApiResourcesToV1Resources(in *kapi.ResourceRequirements) v1.ResourceRequirements

func GetBuildEnv

func GetBuildEnv(build *buildapi.Build) []kapi.EnvVar

GetBuildEnv gets the build strategy environment

func GetBuildName

func GetBuildName(pod metav1.Object) string

GetBuildName returns name of the build pod.

func GetInputReference

func GetInputReference(strategy buildapi.BuildStrategy) *kapi.ObjectReference

GetInputReference returns the From ObjectReference associated with the BuildStrategy.

func IsBuildComplete

func IsBuildComplete(build *buildapi.Build) bool

IsBuildComplete returns whether the provided build is complete or not

func IsPaused

func IsPaused(bc *buildapi.BuildConfig) bool

IsPaused returns true if the provided BuildConfig is paused and cannot be used to create a new Build

func IsTerminalPhase

func IsTerminalPhase(phase buildapi.BuildPhase) bool

IsTerminalPhase returns true if the provided phase is terminal

func MergeTrustedEnvWithoutDuplicates

func MergeTrustedEnvWithoutDuplicates(source []v1.EnvVar, output *[]v1.EnvVar, sourcePrecedence bool)

MergeTrustedEnvWithoutDuplicates merges two environment lists without having duplicate items in the output list. The source list will be filtered such that only whitelisted environment variables are merged into the output list. If sourcePrecedence is true, keys in the source list will override keys in the output list.

func SafeForLoggingBuild

func SafeForLoggingBuild(build *buildapi.Build) *buildapi.Build

SafeForLoggingBuild returns a copy of a Build with proxy credentials redacted.

func SafeForLoggingBuildCommonSpec

func SafeForLoggingBuildCommonSpec(spec *buildapi.CommonSpec) *buildapi.CommonSpec

SafeForLoggingBuildCommonSpec returns a copy of a CommonSpec with proxy credential env variable values redacted.

func SafeForLoggingEnvVar

func SafeForLoggingEnvVar(env []kapi.EnvVar) []kapi.EnvVar

SafeForLoggingEnvVar returns a copy of an EnvVar array with proxy credential values redacted.

func SafeForLoggingEnvironmentList

func SafeForLoggingEnvironmentList(env s2iapi.EnvironmentList) s2iapi.EnvironmentList

SafeForLoggingEnvironmentList returns a copy of an s2i EnvironmentList array with proxy credential values redacted.

func SafeForLoggingS2IConfig

func SafeForLoggingS2IConfig(config *s2iapi.Config) *s2iapi.Config

SafeForLoggingS2IConfig returns a copy of an s2i Config with proxy credentials redacted.

func SafeForLoggingURL

func SafeForLoggingURL(u *url.URL) *url.URL

SafeForLoggingURL removes the user:password section of a url if present. If not present the value is returned unchanged.

func SetBuildEnv

func SetBuildEnv(build *buildapi.Build, env []kapi.EnvVar)

SetBuildEnv replaces the current build environment

func UpdateBuildEnv

func UpdateBuildEnv(build *buildapi.Build, env []kapi.EnvVar)

UpdateBuildEnv updates the strategy environment This will replace the existing variable definitions with provided env

func VersionForBuild

func VersionForBuild(build *buildapi.Build) int

VersionForBuild returns the version from the provided build name. If no version can be found, 0 is returned to indicate no version.