app

package
v1.0.6 Latest Latest
Warning

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

 Go to latest Published: Sep 13, 2015 License: Apache-2.0 Imports: 42 Imported by: 0

Documentation

Overview

Package app defines reference objects used to generate OpenShift API objects

Index

Constants

This section is empty.

Variables

View Source 
var ErrNoLanguageDetected = fmt.Errorf("No language matched the source repository")

ErrNoLanguageDetected is the error returned when no language can be detected by all source code detectors.

Functions

func ContainerPortsFromString 

func ContainerPortsFromString(portString string) ([]kapi.ContainerPort, error)

ContainerPortsFromString extracts sets of port specifications from a comma-delimited string. Each segment must be a single port number (container port) or a colon delimited pair of ports (container port and host port).

func IsBuilderImage 

func IsBuilderImage(image *imageapi.DockerImage) bool

IsBuilderImage checks whether the provided Docker image is a builder image or not

func IsComponentReference 

func IsComponentReference(s string) bool

IsComponentReference returns true if the provided string appears to be a reference to a source repository on disk, at a URL, a docker image name (which might be on a Docker registry or an OpenShift image stream), or a template.

func IsPossibleSourceRepository 

func IsPossibleSourceRepository(s string) bool

IsPossibleSourceRepository checks whether the provided string is a source repository or not

func IsPossibleTemplateFile 

func IsPossibleTemplateFile(value string) bool

IsPossibleTemplateFile returns true if the argument can be a template file

func IsRemoteRepository 

func IsRemoteRepository(s string) bool

IsRemoteRepository checks whether the provided string is a remote repository or not

func JoinEnvironment 

func JoinEnvironment(a, b []kapi.EnvVar) (out []kapi.EnvVar)

JoinEnvironment joins two different sets of environment variables into one, leaving out all the duplicates

func LabelsFromSpec 

func LabelsFromSpec(spec []string) (map[string]string, []string, error)

LabelsFromSpec turns a set of specs NAME=VALUE or NAME- into a map of labels, a remove label list, or an error.

func StrategyAndSourceForRepository 

func StrategyAndSourceForRepository(repo *SourceRepository, image *ImageRef) (*BuildStrategyRef, *SourceRef, error)

StrategyAndSourceForRepository returns the build strategy and source code reference of the provided source repository TODO: user should be able to choose whether to download a remote source ref for more info

Types

type Acceptor 

type Acceptor interface {
	Accept(from interface{}) bool
}

Acceptor is an interface for accepting objects 

var AcceptAll Acceptor = acceptAll{}

AcceptAll accepts all objects 

var AcceptNew Acceptor = acceptNew{}

AcceptNew only accepts runtime.Objects with an empty resource version.

func NewAcceptBuildConfigs 

func NewAcceptBuildConfigs(typer runtime.ObjectTyper) Acceptor

NewAcceptBuildConfigs creates an acceptor accepting BuildConfig objects and ImageStreams objects.

func NewAcceptFirst 

func NewAcceptFirst() Acceptor

NewAcceptFirst returns a new Acceptor

func NewAcceptUnique 

func NewAcceptUnique(typer runtime.ObjectTyper) Acceptor

NewAcceptUnique creates an acceptor that only accepts unique objects by kind and name

type Acceptors 

type Acceptors []Acceptor

Acceptors is a list of acceptors that behave like a single acceptor. All acceptors must accept an object for it to be accepted.

func (Acceptors) Accept 

func (aa Acceptors) Accept(from interface{}) bool

Accept iterates through all acceptors and determines whether the object should be accepted

type BuildRef 

type BuildRef struct {
	Source   *SourceRef
	Input    *ImageRef
	Strategy *BuildStrategyRef
	Output   *ImageRef
	Env      Environment
}

BuildRef is a reference to a build configuration

func (*BuildRef) BuildConfig 

func (r *BuildRef) BuildConfig() (*buildapi.BuildConfig, error)

BuildConfig creates a buildConfig resource from the build configuration reference

type BuildStrategyRef 

type BuildStrategyRef struct {
	IsDockerBuild bool
	Base          *ImageRef
}

BuildStrategyRef is a reference to a build strategy

func (*BuildStrategyRef) BuildStrategy 

func (s *BuildStrategyRef) BuildStrategy(env Environment) (*buildapi.BuildStrategy, []buildapi.BuildTriggerPolicy)

BuildStrategy builds an OpenShift BuildStrategy from a BuildStrategyRef

type BuildStrategyRefGenerator 

type BuildStrategyRefGenerator struct {
	// contains filtered or unexported fields
}

BuildStrategyRefGenerator generates BuildStrategyRef

Flows for BuildStrategyRef SourceRef -> BuildStrategyRef SourceRef + Docker Context -> BuildStrategyRef Docker Context + Parent Image -> BuildStrategyRef STI Builder Image -> BuildStrategyRef

func NewBuildStrategyRefGenerator 

func NewBuildStrategyRefGenerator(sourceDetectors source.Detectors) *BuildStrategyRefGenerator

NewBuildStrategyRefGenerator creates a BuildStrategyRefGenerator

func (*BuildStrategyRefGenerator) FromDockerContextAndParent 

func (g *BuildStrategyRefGenerator) FromDockerContextAndParent(parentRef *ImageRef) (*BuildStrategyRef, error)

FromDockerContextAndParent generates a build strategy ref from a context path and parent image name

func (*BuildStrategyRefGenerator) FromSTIBuilderImage 

func (g *BuildStrategyRefGenerator) FromSTIBuilderImage(image *ImageRef) (*BuildStrategyRef, error)

FromSTIBuilderImage generates a build strategy from a builder image ref

type ComponentInput 

type ComponentInput struct {
	GroupID       int
	From          string
	Argument      string
	Value         string
	ExpectToBuild bool

	Uses          *SourceRepository
	ResolvedMatch *ComponentMatch
	SearchMatches ComponentMatches

	Resolver
	Searcher
}

ComponentInput is the necessary input for creating a component

func NewComponentInput 

func NewComponentInput(input string) (*ComponentInput, string, error)

NewComponentInput returns a new ComponentInput by checking for image using [image]~ (to indicate builder) or [image]~[code] (builder plus code)

func (*ComponentInput) Input 

func (i *ComponentInput) Input() *ComponentInput

Input returns the component input

func (*ComponentInput) NeedsSource 

func (i *ComponentInput) NeedsSource() bool

NeedsSource indicates if the component input needs source code

func (*ComponentInput) Resolve 

func (i *ComponentInput) Resolve() error

Resolve sets the unique match in input

func (*ComponentInput) Search added in v1.0.4 

func (i *ComponentInput) Search() error

Search sets the search matches in input

func (*ComponentInput) String 

func (i *ComponentInput) String() string

func (*ComponentInput) Use 

func (i *ComponentInput) Use(repo *SourceRepository)

Use adds the provided source repository as the used one by the component input

type ComponentMatch 

type ComponentMatch struct {
	Value       string
	Argument    string
	Name        string
	Description string
	Score       float32
	Insecure    bool

	Builder     bool
	Image       *imageapi.DockerImage
	ImageStream *imageapi.ImageStream
	ImageTag    string
	Template    *templateapi.Template

	Meta map[string]string
}

ComponentMatch is a match to a provided component

func (*ComponentMatch) Exact added in v1.0.4 

func (m *ComponentMatch) Exact() bool

Exact checks if the ComponentMatch is an exact match

func (*ComponentMatch) IsImage 

func (m *ComponentMatch) IsImage() bool

IsImage returns whether or not the component match is an image or image stream

func (*ComponentMatch) IsTemplate 

func (m *ComponentMatch) IsTemplate() bool

IsTemplate returns whether or not the component match is a template

func (*ComponentMatch) String 

func (m *ComponentMatch) String() string

type ComponentMatches added in v1.0.4 

type ComponentMatches []*ComponentMatch

ComponentMatches holds multiple ComponentMatch

func (ComponentMatches) Exact added in v1.0.4 

func (m ComponentMatches) Exact() ComponentMatches

Exact returns all ComponentMatch that are an exact match

func (ComponentMatches) Inexact added in v1.0.4 

func (m ComponentMatches) Inexact() ComponentMatches

Inexact returns all ComponentMatch that are not an exact match

type ComponentReference 

type ComponentReference interface {
	// Input contains the input of the component
	Input() *ComponentInput
	// Resolve sets the match in input
	Resolve() error
	// Search sets the search matches in input
	Search() error
	// NeedsSource indicates if the component needs source code
	NeedsSource() bool
}

ComponentReference defines an interface for components

type ComponentReferences 

type ComponentReferences []ComponentReference

ComponentReferences is a set of components

func (ComponentReferences) Group 

func (r ComponentReferences) Group() (refs []ComponentReferences)

Group groups components based on their group ids

func (ComponentReferences) ImageComponentRefs added in v1.0.4 

func (r ComponentReferences) ImageComponentRefs() (refs ComponentReferences)

ImageComponentRefs returns the list of component references to images

func (ComponentReferences) NeedsSource 

func (r ComponentReferences) NeedsSource() (refs ComponentReferences)

NeedsSource returns all the components that need source code in order to build

func (ComponentReferences) String 

func (r ComponentReferences) String() string

func (ComponentReferences) TemplateComponentRefs added in v1.0.4 

func (r ComponentReferences) TemplateComponentRefs() (refs ComponentReferences)

TemplateComponentRefs returns the list of component references to templates

type DeploymentConfigRef 

type DeploymentConfigRef struct {
	Name   string
	Images []*ImageRef
	Env    Environment
	Labels map[string]string
}

DeploymentConfigRef is a reference to a deployment configuration

func (*DeploymentConfigRef) DeploymentConfig 

func (r *DeploymentConfigRef) DeploymentConfig() (*deployapi.DeploymentConfig, error)

DeploymentConfig creates a deploymentConfig resource from the deployment configuration reference

TODO: take a pod template spec as argument

type Detector 

type Detector interface {
	Detect(dir string) (*SourceRepositoryInfo, error)
}

Detector is an interface for detecting information about a source repository

type DockerClient 

type DockerClient interface {
	ListImages(opts docker.ListImagesOptions) ([]docker.APIImages, error)
	InspectImage(name string) (*docker.Image, error)
}

DockerClient is the local interface for the docker client

type DockerClientSearcher added in v1.0.4 

type DockerClientSearcher struct {
	Client DockerClient

	// Optional, will delegate resolution to the registry if no local
	// exact matches are found.
	RegistrySearcher Searcher

	// Insecure, if true will add an annotation to generated ImageStream
	// so that the image can be pulled properly
	Insecure bool
}

DockerClientSearcher finds local docker images locally that match a search value

func (DockerClientSearcher) Search added in v1.0.4 

func (r DockerClientSearcher) Search(terms ...string) (ComponentMatches, error)

Search searches all images in local docker server for images that match terms

type DockerRegistrySearcher added in v1.0.4 

type DockerRegistrySearcher struct {
	Client        dockerregistry.Client
	AllowInsecure bool
}

DockerRegistrySearcher searches for images in a given docker registry. Notice that it only matches exact searches - so a search for "rub" will not return images with the name "ruby". TODO: replace ImageByTag to allow partial matches

func (DockerRegistrySearcher) Search added in v1.0.4 

func (r DockerRegistrySearcher) Search(terms ...string) (ComponentMatches, error)

Search searches in the Docker registry for images that match terms

type Environment 

type Environment map[string]string

Environment holds environment variables for new-app

func NewEnvironment 

func NewEnvironment(envs ...map[string]string) Environment

NewEnvironment returns a new set of environment variables based on all the provided environment variables

func (Environment) List 

func (e Environment) List() []kapi.EnvVar

List sorts and returns all the environment variables

type ErrMultipleMatches 

type ErrMultipleMatches struct {
	Image   string
	Matches []*ComponentMatch
}

ErrMultipleMatches is an error returned to new-app users when multiple matches are found for a given component

func (ErrMultipleMatches) Error 

func (e ErrMultipleMatches) Error() string

func (ErrMultipleMatches) UsageError 

func (e ErrMultipleMatches) UsageError(commandName string) string

UsageError is the usage error message returned when multiple matches are found

type ErrNoMatch 

type ErrNoMatch struct {
	// contains filtered or unexported fields
}

ErrNoMatch is an error returned to new-app users when no match is found for a given component

func (ErrNoMatch) Error 

func (e ErrNoMatch) Error() string

func (ErrNoMatch) UsageError 

func (e ErrNoMatch) UsageError(commandName string) string

UsageError is the usage error message returned when no match is found

type FirstMatchResolver added in v1.0.4 

type FirstMatchResolver struct {
	Searcher Searcher
}

FirstMatchResolver simply takes the first search result returned by the searcher it holds and resolves it to that match. An ErrMultipleMatches will never happen given it will just take the first result, but a ErrNoMatch can happen if the searcher returns no matches.

func (FirstMatchResolver) Resolve added in v1.0.4 

func (r FirstMatchResolver) Resolve(value string) (*ComponentMatch, error)

Resolve resolves as the first match returned by the Searcher

type Generated 

type Generated struct {
	Items []runtime.Object
}

Generated is a list of runtime objects

func (*Generated) WithType 

func (g *Generated) WithType(slicePtr interface{}) bool

WithType extracts a list of runtime objects with the specified type

type GroupedComponentReferences 

type GroupedComponentReferences ComponentReferences

GroupedComponentReferences is a set of components that can be grouped by their group id

func (GroupedComponentReferences) Len 

func (m GroupedComponentReferences) Len() int

func (GroupedComponentReferences) Less 

func (m GroupedComponentReferences) Less(i, j int) bool

func (GroupedComponentReferences) Swap 

func (m GroupedComponentReferences) Swap(i, j int)

type HighestScoreResolver added in v1.0.4 

type HighestScoreResolver struct {
	Searcher Searcher
}

HighestScoreResolver takes search result returned by the searcher it holds and resolves it to the highest scored match present. An ErrMultipleMatches will never happen given it will just take the best scored result, but a ErrNoMatch can happen if the searcher returns no matches.

func (HighestScoreResolver) Resolve added in v1.0.4 

func (r HighestScoreResolver) Resolve(value string) (*ComponentMatch, error)

Resolve resolves as the first highest scored match returned by the Searcher

type HighestUniqueScoreResolver added in v1.0.4 

type HighestUniqueScoreResolver struct {
	Searcher Searcher
}

HighestUniqueScoreResolver takes search result returned by the searcher it holds and resolves it to the highest scored match present. If more than one match exists with that same score, returns an ErrMultipleMatches. A ErrNoMatch can happen if the searcher returns no matches.

func (HighestUniqueScoreResolver) Resolve added in v1.0.4 

func (r HighestUniqueScoreResolver) Resolve(value string) (*ComponentMatch, error)

Resolve resolves as the highest scored match returned by the Searcher, and guarantees the match is unique (the only match with that given score)

type ImageRef 

type ImageRef struct {
	imageapi.DockerImageReference
	AsImageStream bool
	OutputImage   bool
	Insecure      bool
	HasEmptyDir   bool

	// ObjectName overrides the name of the ImageStream produced
	// but does not affect the DockerImageReference
	ObjectName string

	Stream *imageapi.ImageStream
	Info   *imageapi.DockerImage
}

ImageRef is a reference to an image

func InputImageFromMatch 

func InputImageFromMatch(match *ComponentMatch) (*ImageRef, error)

InputImageFromMatch returns an image reference from a component match. The component match will either be an image stream or an image.

func (*ImageRef) BuildOutput 

func (r *ImageRef) BuildOutput() (*buildapi.BuildOutput, error)

BuildOutput returns the BuildOutput of an image reference

func (*ImageRef) BuildTriggers 

func (r *ImageRef) BuildTriggers() []buildapi.BuildTriggerPolicy

BuildTriggers sets up build triggers for the base image

func (*ImageRef) DeployableContainer 

func (r *ImageRef) DeployableContainer() (container *kapi.Container, triggers []deployapi.DeploymentTriggerPolicy, err error)

DeployableContainer sets up a container for the image ready for deployment

func (*ImageRef) ImageStream 

func (r *ImageRef) ImageStream() (*imageapi.ImageStream, error)

ImageStream returns an ImageStream from an image reference

func (*ImageRef) ObjectReference 

func (r *ImageRef) ObjectReference() kapi.ObjectReference

ObjectReference returns an object reference from the image reference

func (*ImageRef) RepoName 

func (r *ImageRef) RepoName() string

RepoName returns the name of the image in namespace/name format

func (*ImageRef) SuggestName 

func (r *ImageRef) SuggestName() (string, bool)

SuggestName suggests a name for an image reference

type ImageRefGenerator 

type ImageRefGenerator interface {
	FromName(name string) (*ImageRef, error)
	FromNameAndPorts(name string, ports []string) (*ImageRef, error)
	FromStream(repo *imageapi.ImageStream, tag string) (*ImageRef, error)
	FromDockerfile(name string, dir string, context string) (*ImageRef, error)
}

ImageRefGenerator is an interface for generating ImageRefs

Generators for ImageRef - Name -> ImageRef - ImageRepo + tag -> ImageRef

func NewImageRefGenerator 

func NewImageRefGenerator() ImageRefGenerator

NewImageRefGenerator creates a new ImageRefGenerator

type ImageStreamByAnnotationSearcher added in v1.0.4 

type ImageStreamByAnnotationSearcher struct {
	Client            client.ImageStreamsNamespacer
	ImageStreamImages client.ImageStreamImagesNamespacer
	Namespaces        []string
	// contains filtered or unexported fields
}

ImageStreamByAnnotationSearcher searches for image streams based on 'supports' annotations found in tagged images belonging to the stream

func (*ImageStreamByAnnotationSearcher) Search added in v1.0.4 

func (r *ImageStreamByAnnotationSearcher) Search(terms ...string) (ComponentMatches, error)

Search finds image stream images using their 'supports' annotation

type ImageStreamSearcher added in v1.0.4 

type ImageStreamSearcher struct {
	Client            client.ImageStreamsNamespacer
	ImageStreamImages client.ImageStreamImagesNamespacer
	Namespaces        []string
}

ImageStreamSearcher searches the openshift server image streams for images matching a particular name

func (ImageStreamSearcher) Search added in v1.0.4 

func (r ImageStreamSearcher) Search(terms ...string) (ComponentMatches, error)

Search will attempt to find imagestreams with names that matches the passed in value

type MultiSimpleSearcher added in v1.0.4 

type MultiSimpleSearcher []Searcher

MultiSimpleSearcher is a set of searchers

func (MultiSimpleSearcher) Search added in v1.0.4 

func (s MultiSimpleSearcher) Search(terms ...string) (ComponentMatches, error)

Search searches using all searchers it holds

type MultiWeightedSearcher added in v1.0.4 

type MultiWeightedSearcher []WeightedSearcher

MultiWeightedSearcher is a set of weighted searchers where lower weight has higher priority in search results

func (MultiWeightedSearcher) Search added in v1.0.4 

func (s MultiWeightedSearcher) Search(terms ...string) (ComponentMatches, error)

Search searches using all searchers it holds and score according to searcher height

type NameSuggester 

type NameSuggester interface {
	SuggestName() (string, bool)
}

NameSuggester is an object that can suggest a name for itself

type NameSuggestions 

type NameSuggestions []NameSuggester

NameSuggestions suggests names from a collection of NameSuggesters

func (NameSuggestions) SuggestName 

func (s NameSuggestions) SuggestName() (string, bool)

SuggestName suggests a name given a collection of NameSuggesters

type Objects 

type Objects []runtime.Object

Objects is a set of runtime objects

func AddRoutes 

func AddRoutes(objects Objects) Objects

AddRoutes sets up routes for the provided objects

func AddServices 

func AddServices(objects Objects, firstPortOnly bool) Objects

AddServices sets up services for the provided objects

type PassThroughDockerSearcher added in v1.0.4 

type PassThroughDockerSearcher struct{}

PassThroughDockerSearcher returns a match with the value that was passed in

func (*PassThroughDockerSearcher) Search added in v1.0.4 

func (r *PassThroughDockerSearcher) Search(terms ...string) (ComponentMatches, error)

Search always returns a match for every term passed in

type PerfectMatchWeightedResolver 

type PerfectMatchWeightedResolver []WeightedResolver

PerfectMatchWeightedResolver returns only matches from resolvers that are identified as exact (weight 0.0), and only matches from those resolvers that qualify as exact (score = 0.0). If no perfect matches exist, an ErrMultipleMatches is returned indicating the remaining candidate(s). Note that this method may resolve ErrMultipleMatches with a single match, indicating an error (no perfect match) but with only one candidate.

func (PerfectMatchWeightedResolver) Resolve 

func (r PerfectMatchWeightedResolver) Resolve(value string) (*ComponentMatch, error)

Resolve resolves the provided input and returns only exact matches

type Pipeline 

type Pipeline struct {
	From string

	InputImage *ImageRef
	Build      *BuildRef
	Image      *ImageRef
	Deployment *DeploymentConfigRef
	Labels     map[string]string
}

Pipeline holds components

func NewBuildPipeline 

func NewBuildPipeline(from string, input *ImageRef, outputDocker bool, strategy *BuildStrategyRef, env Environment, source *SourceRef) (*Pipeline, error)

NewBuildPipeline creates a new pipeline with components that are expected to be built

func NewImagePipeline 

func NewImagePipeline(from string, image *ImageRef) (*Pipeline, error)

NewImagePipeline creates a new pipeline with components that are not expected to be built

func (*Pipeline) NeedsDeployment 

func (p *Pipeline) NeedsDeployment(env Environment, labels map[string]string, name string) error

NeedsDeployment sets the pipeline for deployment

func (*Pipeline) Objects 

func (p *Pipeline) Objects(accept, objectAccept Acceptor) (Objects, error)

Objects converts all the components in the pipeline into runtime objects

type PipelineGroup 

type PipelineGroup []*Pipeline

PipelineGroup is a group of Pipelines

func (PipelineGroup) Reduce 

func (g PipelineGroup) Reduce() error

Reduce squashes all common components from the pipelines

func (PipelineGroup) String 

func (g PipelineGroup) String() string

type ReferenceBuilder 

type ReferenceBuilder struct {
	// contains filtered or unexported fields
}

ReferenceBuilder is used for building all the necessary object references for an application

func (*ReferenceBuilder) AddComponents 

func (r *ReferenceBuilder) AddComponents(inputs []string, fn func(*ComponentInput) ComponentReference) ComponentReferences

AddComponents turns all provided component inputs into component references

func (*ReferenceBuilder) AddGroups 

func (r *ReferenceBuilder) AddGroups(inputs []string)

AddGroups adds group ids to groups of components

func (*ReferenceBuilder) AddSourceRepository 

func (r *ReferenceBuilder) AddSourceRepository(input string) (*SourceRepository, bool)

AddSourceRepository resolves the input to an actual source repository

func (*ReferenceBuilder) Result 

func (r *ReferenceBuilder) Result() (ComponentReferences, SourceRepositories, []error)

Result returns the result of the config conversion to object references

type Resolver 

type Resolver interface {
	Resolve(value string) (*ComponentMatch, error)
}

Resolver is an interface for resolving provided input to component matches. A Resolver should return ErrMultipleMatches when more than one result can be constructed as a match. It should also set the score to 0.0 if this is a perfect match, and to higher values the less adequate the match is.

type ScoredComponentMatches 

type ScoredComponentMatches []*ComponentMatch

ScoredComponentMatches is a set of component matches grouped by score

func (ScoredComponentMatches) Exact 

func (m ScoredComponentMatches) Exact() []*ComponentMatch

Exact returns all the exact component matches

func (ScoredComponentMatches) Len 

func (m ScoredComponentMatches) Len() int

func (ScoredComponentMatches) Less 

func (m ScoredComponentMatches) Less(i, j int) bool

func (ScoredComponentMatches) Swap 

func (m ScoredComponentMatches) Swap(i, j int)

type Searcher 

type Searcher interface {
	Search(terms ...string) (ComponentMatches, error)
}

Searcher is responsible for performing a search based on the given terms and return all results found as component matches. Notice they can even return zero or multiple matches, meaning they will never return ErrNoMatch or ErrMultipleMatches and any error returned is an actual error. The component match score can be used to determine how precise a given match is, where 0.0 is an exact match.

func NewImageStreamByAnnotationSearcher added in v1.0.4 

func NewImageStreamByAnnotationSearcher(streamClient client.ImageStreamsNamespacer, imageClient client.ImageStreamImagesNamespacer, namespaces []string) Searcher

NewImageStreamByAnnotationSearcher creates a new ImageStreamByAnnotationSearcher

type SourceLanguageType 

type SourceLanguageType struct {
	Platform string
	Version  string
}

SourceLanguageType contains info about the type of the language a source repository is built in

func (*SourceLanguageType) Term 

func (t *SourceLanguageType) Term() string

Term returns a search term for the given source language type the term will be in the form of language:version

type SourceRef 

type SourceRef struct {
	URL        *url.URL
	Ref        string
	Dir        string
	Name       string
	ContextDir string
}

SourceRef is a reference to a build source

func (*SourceRef) BuildSource 

func (r *SourceRef) BuildSource() (*buildapi.BuildSource, []buildapi.BuildTriggerPolicy)

BuildSource returns an OpenShift BuildSource from the SourceRef

func (*SourceRef) SuggestName 

func (r *SourceRef) SuggestName() (string, bool)

SuggestName returns a name derived from the source URL

type SourceRefGenerator 

type SourceRefGenerator struct {
	// contains filtered or unexported fields
}

SourceRefGenerator generates new SourceRefs either from a URL or a Directory

Generators for SourceRef - Git URL -> SourceRef - Directory -> SourceRef

func NewSourceRefGenerator 

func NewSourceRefGenerator() *SourceRefGenerator

NewSourceRefGenerator creates a new SourceRefGenerator

func (*SourceRefGenerator) FromDirectory 

func (g *SourceRefGenerator) FromDirectory(directory string) (*SourceRef, error)

FromDirectory creates a SourceRef from a directory that contains a git repository. The URL is obtained from the origin remote branch, and the reference is taken from the currently checked out branch.

func (*SourceRefGenerator) FromGitURL 

func (g *SourceRefGenerator) FromGitURL(location, contextDir string) (*SourceRef, error)

FromGitURL creates a SourceRef from a Git URL. If the URL includes a hash, it is used for the SourceRef's branch reference. Otherwise, 'master' is assumed

type SourceRepositories 

type SourceRepositories []*SourceRepository

SourceRepositories is a list of SourceRepository objects

func (SourceRepositories) NotUsed 

func (rr SourceRepositories) NotUsed() SourceRepositories

NotUsed returns the list of SourceRepositories that are not used

func (SourceRepositories) String 

func (rr SourceRepositories) String() string

type SourceRepository 

type SourceRepository struct {
	// contains filtered or unexported fields
}

SourceRepository represents a code repository that may be the target of a build.

func MockSourceRepositories 

func MockSourceRepositories() []*SourceRepository

MockSourceRepositories is a set of mocked source repositories used for testing

func NewSourceRepository 

func NewSourceRepository(s string) (*SourceRepository, error)

NewSourceRepository creates a reference to a local or remote source code repository from a URL or path.

func (*SourceRepository) BuildWithDocker 

func (r *SourceRepository) BuildWithDocker()

BuildWithDocker specifies that the source repository was built with Docker

func (*SourceRepository) ContextDir 

func (r *SourceRepository) ContextDir() string

ContextDir returns the context directory of the source repository

func (*SourceRepository) Detect 

func (r *SourceRepository) Detect(d Detector) error

Detect clones source locally if not already local and runs code detection with the given detector.

func (*SourceRepository) InUse 

func (r *SourceRepository) InUse() bool

InUse checks if the source repository is in use

func (*SourceRepository) Info 

func (r *SourceRepository) Info() *SourceRepositoryInfo

Info returns the source repository info generated on code detection

func (*SourceRepository) IsDockerBuild 

func (r *SourceRepository) IsDockerBuild() bool

IsDockerBuild checks if the source repository was built with Docker

func (*SourceRepository) LocalPath 

func (r *SourceRepository) LocalPath() (string, error)

LocalPath returns the local path of the source repository

func (*SourceRepository) Remote 

func (r *SourceRepository) Remote() bool

Remote checks whether the source repository is remote

func (*SourceRepository) RemoteURL 

func (r *SourceRepository) RemoteURL() (*url.URL, error)

RemoteURL returns the remote URL of the source repository

func (*SourceRepository) SetContextDir 

func (r *SourceRepository) SetContextDir(dir string)

SetContextDir sets the context directory to use for the source repository

func (*SourceRepository) SetInfo added in v1.0.1 

func (r *SourceRepository) SetInfo(info *SourceRepositoryInfo)

SetInfo sets the source repository info. This is to facilitate certain tests.

func (*SourceRepository) String 

func (r *SourceRepository) String() string

func (*SourceRepository) UsedBy 

func (r *SourceRepository) UsedBy(ref ComponentReference)

UsedBy sets up which component uses the source repository

type SourceRepositoryEnumerator 

type SourceRepositoryEnumerator struct {
	Detectors source.Detectors
	Tester    dockerfile.Tester
}

SourceRepositoryEnumerator implements the Detector interface

func (SourceRepositoryEnumerator) Detect 

func (e SourceRepositoryEnumerator) Detect(dir string) (*SourceRepositoryInfo, error)

Detect extracts source code information about the provided source repository

type SourceRepositoryInfo 

type SourceRepositoryInfo struct {
	Path       string
	Types      []SourceLanguageType
	Dockerfile dockerfile.Dockerfile
}

SourceRepositoryInfo contains info about a source repository

func (*SourceRepositoryInfo) Terms 

func (info *SourceRepositoryInfo) Terms() []string

Terms returns which languages the source repository was built with

type TemplateFileSearcher added in v1.0.4 

type TemplateFileSearcher struct {
	Mapper       meta.RESTMapper
	Typer        runtime.ObjectTyper
	ClientMapper resource.ClientMapper
	Namespace    string
}

TemplateFileSearcher resolves template files into template objects

func (*TemplateFileSearcher) Search added in v1.0.4 

func (r *TemplateFileSearcher) Search(terms ...string) (ComponentMatches, error)

Search attemps to read template files and transform it into template objects

type TemplateSearcher added in v1.0.4 

type TemplateSearcher struct {
	Client                    client.TemplatesNamespacer
	TemplateConfigsNamespacer client.TemplateConfigsNamespacer
	Namespaces                []string
}

TemplateSearcher resolves stored template arguments into template objects

func (TemplateSearcher) Search added in v1.0.4 

func (r TemplateSearcher) Search(terms ...string) (ComponentMatches, error)

Search searches for a template and returns matches with the object representation

type UniqueExactOrInexactMatchResolver added in v1.0.4 

type UniqueExactOrInexactMatchResolver struct {
	Searcher Searcher
}

UniqueExactOrInexactMatchResolver takes search result returned by the searcher it holds. Returns the single exact match present, if more that one exact match is present, returns a ErrMultipleMatches. If no exact match is present, try with inexact ones, which must also be unique otherwise ErrMultipleMatches. A ErrNoMatch can happen if the searcher returns no exact or inexact matches.

func (UniqueExactOrInexactMatchResolver) Resolve added in v1.0.4 

func (r UniqueExactOrInexactMatchResolver) Resolve(value string) (*ComponentMatch, error)

Resolve resolves as the single exact or inexact match present

type WeightedResolver 

type WeightedResolver struct {
	Searcher
	Weight float32
}

WeightedResolver is a resolver identified as exact or not, depending on its weight

type WeightedResolvers 

type WeightedResolvers []WeightedResolver

WeightedResolvers is a set of weighted resolvers

func (WeightedResolvers) Resolve 

func (r WeightedResolvers) Resolve(value string) (*ComponentMatch, error)

Resolve resolves the provided input and returns both exact and inexact matches

type WeightedSearcher added in v1.0.4 

type WeightedSearcher struct {
	Searcher
	Weight float32
}

WeightedSearcher is a searcher identified as exact or not, depending on its weight

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.