util

func AdjustConfigWithImageLabels ¶ added in v1.3.2

func AdjustConfigWithImageLabels(cfg *api.Config) (string, string)

AdjustConfigWithImageLabels examines previously retrieved builder image labels and returns any specified update to the scripts URL and destination settings. Note, we do not set those fields in the Config object itself, so as to not confuse the s2i build case in which the script install code expects those values to set via the explicit command line argument overrides. Otherwise, we can inadvertently override scripts from the source repo.

func CreateInjectionResultFile ¶ added in v1.1.12

func CreateInjectionResultFile(injectErr error) (string, error)

CreateInjectionResultFile creates a result file with the message from the provided injection error. The path to the result file is returned. If the provided error is nil, an empty file is created.

func CreateTruncateFilesScript ¶ added in v1.1.10

func CreateTruncateFilesScript(files []string, scriptName string) (string, error)

CreateTruncateFilesScript creates a shell script that contains truncation of all files we injected into the container. The path to the script is returned. When the scriptName is provided, it is also truncated together with all secrets.

func FirstNonEmpty ¶ added in v1.1.12

func FirstNonEmpty(args ...string) string

FirstNonEmpty returns the first non-empty string in the provided list of strings.

func FixInjectionsWithRelativePath ¶ added in v1.0.5

func FixInjectionsWithRelativePath(workdir string, injections api.VolumeList) api.VolumeList

FixInjectionsWithRelativePath fixes the injections that does not specify the destination directory or the directory is relative to use the provided working directory.

func GenerateLabelsFromConfig ¶ added in v1.0.2

func GenerateLabelsFromConfig(labels map[string]string, config *api.Config, namespace string) map[string]string

GenerateLabelsFromConfig generate the labels based on build s2i Config

func GenerateLabelsFromSourceInfo ¶ added in v1.0.2

func GenerateLabelsFromSourceInfo(labels map[string]string, info *git.SourceInfo, namespace string) map[string]string

GenerateLabelsFromSourceInfo generate the labels based on the source repository informations.

func GenerateOutputImageLabels ¶ added in v1.0.1

func GenerateOutputImageLabels(info *git.SourceInfo, config *api.Config) map[string]string

GenerateOutputImageLabels generate the labels based on the s2i Config and source repository informations.

func HandleInjectionError ¶ added in v1.0.5

func HandleInjectionError(p api.VolumeSpec, err error) error

HandleInjectionError handles the error caused by injection and provide reasonable suggestion to users.

func Includes ¶ added in v1.1.12

func Includes(arr []string, str string) bool

Includes determines if the given string is in the provided slice of strings.

func IsTimeoutError ¶ added in v1.0.6

func IsTimeoutError(e error) bool

IsTimeoutError checks if the provided error is a TimeoutError.

func ListFiles ¶ added in v1.1.10

func ListFiles(fs fs.FileSystem, spec api.VolumeSpec) ([]string, error)

ListFiles returns a flat list of all files injected into a container for the given `VolumeSpec`.

func ListFilesToTruncate ¶ added in v1.1.10

func ListFilesToTruncate(fs fs.FileSystem, injections api.VolumeList) ([]string, error)

ListFilesToTruncate returns a flat list of all files that are injected into a container which need to be truncated. All files from nested directories are returned in the list.

func ReadEnvironmentFile ¶ added in v1.0.1

func ReadEnvironmentFile(path string) (map[string]string, error)

ReadEnvironmentFile reads the content for a file that contains a list of environment variables and values. The key-pairs are separated by a new line character. The file can also have comments (both '#' and '//' are supported).

func SafeForLoggingContainerConfig ¶ added in v1.1.6

func SafeForLoggingContainerConfig(config *container.Config) *container.Config

SafeForLoggingContainerConfig returns a copy of the container.Config object with sensitive information (proxy environment variables containing credentials) redacted.

func SafeForLoggingEnv ¶ added in v1.1.6

func SafeForLoggingEnv(env []string) []string

SafeForLoggingEnv attempts to strip sensitive information from proxy environment variable strings in key=value form.

func SafeForLoggingURL ¶ added in v1.1.6

func SafeForLoggingURL(input string) (string, error)

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

func TimeoutAfter ¶ added in v1.0.6

func TimeoutAfter(t time.Duration, errorMsg string, f func(*time.Timer) error) error

TimeoutAfter executes the provided function and returns TimeoutError in the case that the execution time of the function exceeded the provided duration. The provided function is passed the timer in case it wishes to reset it. If so, the following pattern must be used:

if !timer.Stop() {
  return &TimeoutError{}
}

timer.Reset(timeout)