api

package
v1.4.0 Latest Latest
Warning

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

Go to latest
Published: Jan 14, 2017 License: Apache-2.0 Imports: 10 Imported by: 0

Documentation

Overview

Package api is the internal version of the API.

Index

Constants

View Source
const (
	// BuildAnnotation is an annotation that identifies a Pod as being for a Build
	BuildAnnotation = "openshift.io/build.name"
	// BuildConfigAnnotation is an annotation that identifies the BuildConfig that a Build was created from
	BuildConfigAnnotation = "openshift.io/build-config.name"
	// BuildNumberAnnotation is an annotation whose value is the sequential number for this Build
	BuildNumberAnnotation = "openshift.io/build.number"
	// BuildCloneAnnotation is an annotation whose value is the name of the build this build was cloned from
	BuildCloneAnnotation = "openshift.io/build.clone-of"
	// BuildPodNameAnnotation is an annotation whose value is the name of the pod running this build
	BuildPodNameAnnotation = "openshift.io/build.pod-name"
	// BuildJenkinsStatusJSONAnnotation is an annotation holding the Jenkins status information
	BuildJenkinsStatusJSONAnnotation = "openshift.io/jenkins-status-json"
	// BuildJenkinsLogURLAnnotation is an annotation holding a link to the Jenkins build console log
	BuildJenkinsLogURLAnnotation = "openshift.io/jenkins-log-url"
	// BuildJenkinsBuildURIAnnotation is an annotation holding a link to the Jenkins build
	BuildJenkinsBuildURIAnnotation = "openshift.io/jenkins-build-uri"
	// BuildLabel is the key of a Pod label whose value is the Name of a Build which is run.
	// NOTE: The value for this label may not contain the entire Build name because it will be
	// truncated to maximum label length.
	BuildLabel = "openshift.io/build.name"
	// BuildRunPolicyLabel represents the start policy used to to start the build.
	BuildRunPolicyLabel = "openshift.io/build.start-policy"
	// DefaultDockerLabelNamespace is the key of a Build label, whose values are build metadata.
	DefaultDockerLabelNamespace = "io.openshift."
	// OriginVersion is an environment variable key that indicates the version of origin that
	// created this build definition.
	OriginVersion = "ORIGIN_VERSION"
	// AllowedUIDs is an environment variable that contains ranges of UIDs that are allowed in
	// Source builder images
	AllowedUIDs = "ALLOWED_UIDS"
	// DropCapabilities is an environment variable that contains a list of capabilities to drop when
	// executing a Source build
	DropCapabilities = "DROP_CAPS"
	// BuildConfigLabel is the key of a Build label whose value is the ID of a BuildConfig
	// on which the Build is based. NOTE: The value for this label may not contain the entire
	// BuildConfig name because it will be truncated to maximum label length.
	BuildConfigLabel = "openshift.io/build-config.name"
	// BuildConfigLabelDeprecated was used as BuildConfigLabel before adding namespaces.
	// We keep it for backward compatibility.
	BuildConfigLabelDeprecated = "buildconfig"
	// BuildConfigPausedAnnotation is an annotation that marks a BuildConfig as paused.
	// New Builds cannot be instantiated from a paused BuildConfig.
	BuildConfigPausedAnnotation = "openshift.io/build-config.paused"
)
View Source
const (
	BuildTriggerCauseManualMsg  = "Manually triggered"
	BuildTriggerCauseConfigMsg  = "Build configuration change"
	BuildTriggerCauseImageMsg   = "Image change"
	BuildTriggerCauseGithubMsg  = "GitHub WebHook"
	BuildTriggerCauseGenericMsg = "Generic WebHook"
)
View Source
const (
	// BuildPodSuffix is the suffix used to append to a build pod name given a build name
	BuildPodSuffix = "build"
)
View Source
const (
	// CustomBuildStrategyBaseImageKey is the environment variable that indicates the base image to be used when
	// performing a custom build, if needed.
	CustomBuildStrategyBaseImageKey = "OPENSHIFT_CUSTOM_BUILD_BASE_IMAGE"
)
View Source
const FutureGroupName = "build.openshift.io"
View Source
const GroupName = ""

Variables

View Source
var (
	SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes)
	AddToScheme   = SchemeBuilder.AddToScheme
)

NOTE: Adding a new trigger type requires adding the type to KnownTriggerTypes

View Source
var SchemeGroupVersion = unversioned.GroupVersion{Group: GroupName, Version: runtime.APIVersionInternal}

SchemeGroupVersion is group version used to register these objects

Functions

func BuildConfigToSelectableFields added in v1.0.8

func BuildConfigToSelectableFields(buildConfig *BuildConfig) fields.Set

BuildConfigToSelectableFields returns a label set that represents the object changes to the returned keys require registering conversions for existing versions using Scheme.AddFieldLabelConversionFunc

func BuildToPodLogOptions added in v1.0.8

func BuildToPodLogOptions(opts *BuildLogOptions) *kapi.PodLogOptions

BuildToPodLogOptions builds a PodLogOptions object out of a BuildLogOptions. Currently BuildLogOptions.Container and BuildLogOptions.Previous aren't used so they won't be copied to PodLogOptions.

func BuildToSelectableFields added in v1.0.8

func BuildToSelectableFields(build *Build) fields.Set

BuildToSelectableFields returns a label set that represents the object changes to the returned keys require registering conversions for existing versions using Scheme.AddFieldLabelConversionFunc

func DeepCopy_api_BinaryBuildRequestOptions added in v1.3.0

func DeepCopy_api_BinaryBuildRequestOptions(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BinaryBuildSource added in v1.3.0

func DeepCopy_api_BinaryBuildSource(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_Build added in v1.3.0

func DeepCopy_api_Build(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildConfig added in v1.3.0

func DeepCopy_api_BuildConfig(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildConfigList added in v1.3.0

func DeepCopy_api_BuildConfigList(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildConfigSpec added in v1.3.0

func DeepCopy_api_BuildConfigSpec(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildConfigStatus added in v1.3.0

func DeepCopy_api_BuildConfigStatus(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildList added in v1.3.0

func DeepCopy_api_BuildList(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildLog added in v1.3.0

func DeepCopy_api_BuildLog(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildLogOptions added in v1.3.0

func DeepCopy_api_BuildLogOptions(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildOutput added in v1.3.0

func DeepCopy_api_BuildOutput(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildPostCommitSpec added in v1.3.0

func DeepCopy_api_BuildPostCommitSpec(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildRequest added in v1.3.0

func DeepCopy_api_BuildRequest(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildSource added in v1.3.0

func DeepCopy_api_BuildSource(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildSpec added in v1.3.0

func DeepCopy_api_BuildSpec(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildStatus added in v1.3.0

func DeepCopy_api_BuildStatus(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildStrategy added in v1.3.0

func DeepCopy_api_BuildStrategy(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildTriggerCause added in v1.3.0

func DeepCopy_api_BuildTriggerCause(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_BuildTriggerPolicy added in v1.3.0

func DeepCopy_api_BuildTriggerPolicy(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_CommonSpec added in v1.3.0

func DeepCopy_api_CommonSpec(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_CustomBuildStrategy added in v1.3.0

func DeepCopy_api_CustomBuildStrategy(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_DockerBuildStrategy added in v1.3.0

func DeepCopy_api_DockerBuildStrategy(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_GenericWebHookCause added in v1.3.0

func DeepCopy_api_GenericWebHookCause(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_GenericWebHookEvent added in v1.3.0

func DeepCopy_api_GenericWebHookEvent(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_GitBuildSource added in v1.3.0

func DeepCopy_api_GitBuildSource(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_GitHubWebHookCause added in v1.3.0

func DeepCopy_api_GitHubWebHookCause(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_GitInfo added in v1.3.0

func DeepCopy_api_GitInfo(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_GitRefInfo added in v1.3.0

func DeepCopy_api_GitRefInfo(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_GitSourceRevision added in v1.3.0

func DeepCopy_api_GitSourceRevision(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_ImageChangeCause added in v1.3.0

func DeepCopy_api_ImageChangeCause(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_ImageChangeTrigger added in v1.3.0

func DeepCopy_api_ImageChangeTrigger(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_ImageLabel added in v1.4.0

func DeepCopy_api_ImageLabel(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_ImageSource added in v1.3.0

func DeepCopy_api_ImageSource(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_ImageSourcePath added in v1.3.0

func DeepCopy_api_ImageSourcePath(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_JenkinsPipelineBuildStrategy added in v1.3.0

func DeepCopy_api_JenkinsPipelineBuildStrategy(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_ProxyConfig added in v1.4.0

func DeepCopy_api_ProxyConfig(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_SecretBuildSource added in v1.3.0

func DeepCopy_api_SecretBuildSource(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_SecretSpec added in v1.3.0

func DeepCopy_api_SecretSpec(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_SourceBuildStrategy added in v1.3.0

func DeepCopy_api_SourceBuildStrategy(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_SourceControlUser added in v1.3.0

func DeepCopy_api_SourceControlUser(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_SourceRevision added in v1.3.0

func DeepCopy_api_SourceRevision(in interface{}, out interface{}, c *conversion.Cloner) error

func DeepCopy_api_WebHookTrigger added in v1.3.0

func DeepCopy_api_WebHookTrigger(in interface{}, out interface{}, c *conversion.Cloner) error

func GetBuildName added in v1.3.0

func GetBuildName(pod *kapi.Pod) string

GetBuildName returns the name of a Build associated with the given Pod.

func GetBuildPodName added in v1.0.8

func GetBuildPodName(build *Build) string

GetBuildPodName returns name of the build pod.

func Kind added in v1.1.2

func Kind(kind string) unversioned.GroupKind

Kind takes an unqualified kind and returns back a Group qualified GroupKind

func LabelValue added in v1.3.0

func LabelValue(name string) string

LabelValue returns a string to use as a value for the Build label in a pod. If the length of the string parameter exceeds the maximum label length, the value will be truncated.

func RegisterDeepCopies added in v1.4.0

func RegisterDeepCopies(scheme *runtime.Scheme) error

RegisterDeepCopies adds deep-copy functions to the given scheme. Public to allow building arbitrary schemes.

func Resource added in v1.1.2

func Resource(resource string) unversioned.GroupResource

Resource takes an unqualified resource and returns back a Group qualified GroupResource

func SourceType added in v1.1.1

func SourceType(source BuildSource) string

func StrategyType added in v1.1.1

func StrategyType(strategy BuildStrategy) string

Types

type BinaryBuildRequestOptions added in v1.0.7

type BinaryBuildRequestOptions struct {
	unversioned.TypeMeta
	kapi.ObjectMeta

	AsFile string

	// Commit is the value identifying a specific commit
	Commit string

	// Message is the description of a specific commit
	Message string

	// AuthorName of the source control user
	AuthorName string

	// AuthorEmail of the source control user
	AuthorEmail string

	// CommitterName of the source control user
	CommitterName string

	// CommitterEmail of the source control user
	CommitterEmail string
}

func (*BinaryBuildRequestOptions) GetObjectKind added in v1.1.3

func (obj *BinaryBuildRequestOptions) GetObjectKind() unversioned.ObjectKind

type BinaryBuildSource added in v1.0.7

type BinaryBuildSource struct {
	// AsFile indicates that the provided binary input should be considered a single file
	// within the build input. For example, specifying "webapp.war" would place the provided
	// binary as `/webapp.war` for the builder. If left empty, the Docker and Source build
	// strategies assume this file is a zip, tar, or tar.gz file and extract it as the source.
	// The custom strategy receives this binary as standard input. This filename may not
	// contain slashes or be '..' or '.'.
	AsFile string
}

type Build

type Build struct {
	unversioned.TypeMeta
	kapi.ObjectMeta

	// Spec is all the inputs used to execute the build.
	Spec BuildSpec

	// Status is the current status of the build.
	Status BuildStatus
}

Build encapsulates the inputs needed to produce a new deployable image, as well as the status of the execution and a reference to the Pod which executed the build.

func FilterBuilds added in v1.1.1

func FilterBuilds(builds []Build, predicate PredicateFunc) []Build

FilterBuilds returns array of builds that satisfies predicate function.

func (*Build) GetObjectKind added in v1.1.3

func (obj *Build) GetObjectKind() unversioned.ObjectKind

type BuildConfig

type BuildConfig struct {
	unversioned.TypeMeta
	kapi.ObjectMeta

	// Spec holds all the input necessary to produce a new build, and the conditions when
	// to trigger them.
	Spec BuildConfigSpec
	// Status holds any relevant information about a build config
	Status BuildConfigStatus
}

BuildConfig is a template which can be used to create new builds.

func (*BuildConfig) GetObjectKind added in v1.1.3

func (obj *BuildConfig) GetObjectKind() unversioned.ObjectKind

type BuildConfigList

type BuildConfigList struct {
	unversioned.TypeMeta
	unversioned.ListMeta

	// Items is a list of build configs
	Items []BuildConfig
}

BuildConfigList is a collection of BuildConfigs.

func (*BuildConfigList) GetObjectKind added in v1.1.3

func (obj *BuildConfigList) GetObjectKind() unversioned.ObjectKind

type BuildConfigSpec added in v1.0.2

type BuildConfigSpec struct {
	// Triggers determine how new Builds can be launched from a BuildConfig. If
	// no triggers are defined, a new build can only occur as a result of an
	// explicit client build creation.
	Triggers []BuildTriggerPolicy

	// RunPolicy describes how the new build created from this build
	// configuration will be scheduled for execution.
	// This is optional, if not specified we default to "Serial".
	RunPolicy BuildRunPolicy

	// CommonSpec is the desired build specification
	CommonSpec
}

BuildConfigSpec describes when and how builds are created

type BuildConfigStatus added in v1.0.2

type BuildConfigStatus struct {
	// LastVersion is used to inform about number of last triggered build.
	LastVersion int64
}

BuildConfigStatus contains current state of the build config object.

type BuildList

type BuildList struct {
	unversioned.TypeMeta
	unversioned.ListMeta

	// Items is a list of builds
	Items []Build
}

BuildList is a collection of Builds.

func (*BuildList) GetObjectKind added in v1.1.3

func (obj *BuildList) GetObjectKind() unversioned.ObjectKind

type BuildLog

type BuildLog struct {
	unversioned.TypeMeta
}

BuildLog is the (unused) resource associated with the build log redirector

func (*BuildLog) GetObjectKind added in v1.1.3

func (obj *BuildLog) GetObjectKind() unversioned.ObjectKind

type BuildLogOptions

type BuildLogOptions struct {
	unversioned.TypeMeta

	// Container for which to return logs
	Container string
	// Follow if true indicates that the build log should be streamed until
	// the build terminates.
	Follow bool
	// If true, return previous build logs.
	Previous bool
	// A relative time in seconds before the current time from which to show logs. If this value
	// precedes the time a pod was started, only logs since the pod start will be returned.
	// If this value is in the future, no logs will be returned.
	// Only one of sinceSeconds or sinceTime may be specified.
	SinceSeconds *int64
	// An RFC3339 timestamp from which to show logs. If this value
	// precedes the time a pod was started, only logs since the pod start will be returned.
	// If this value is in the future, no logs will be returned.
	// Only one of sinceSeconds or sinceTime may be specified.
	SinceTime *unversioned.Time
	// If true, add an RFC3339 or RFC3339Nano timestamp at the beginning of every line
	// of log output.
	Timestamps bool
	// If set, the number of lines from the end of the logs to show. If not specified,
	// logs are shown from the creation of the container or sinceSeconds or sinceTime
	TailLines *int64
	// If set, the number of bytes to read from the server before terminating the
	// log output. This may not display a complete final line of logging, and may return
	// slightly more or slightly less than the specified limit.
	LimitBytes *int64

	// NoWait if true causes the call to return immediately even if the build
	// is not available yet. Otherwise the server will wait until the build has started.
	NoWait bool

	// Version of the build for which to view logs.
	Version *int64
}

BuildLogOptions is the REST options for a build log

func (*BuildLogOptions) GetObjectKind added in v1.1.3

func (obj *BuildLogOptions) GetObjectKind() unversioned.ObjectKind

type BuildOutput

type BuildOutput struct {
	// To defines an optional location to push the output of this build to.
	// Kind must be one of 'ImageStreamTag' or 'DockerImage'.
	// This value will be used to look up a Docker image repository to push to.
	// In the case of an ImageStreamTag, the ImageStreamTag will be looked for in the namespace of
	// the build unless Namespace is specified.
	To *kapi.ObjectReference

	// PushSecret is the name of a Secret that would be used for setting
	// up the authentication for executing the Docker push to authentication
	// enabled Docker Registry (or Docker Hub).
	PushSecret *kapi.