v1alpha1

package
v0.14.0 Latest Latest
Warning

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

 Go to latest Published: Nov 8, 2024 License: Apache-2.0 Imports: 6 Imported by: 20

Documentation

Overview

Package v1alpha1 contains API Schema definitions for the build v1alpha1 API group +k8s:deepcopy-gen=package,register +groupName=shipwright.io

Package v1alpha1 contains API Schema definitions for the build v1alpha1 API group +k8s:deepcopy-gen=package,register +groupName=shipwright.io

SPDX-License-Identifier: Apache-2.0

SPDX-License-Identifier: Apache-2.0

SPDX-License-Identifier: Apache-2.0

Index

Constants

View Source 
const (
	// BuildDomain is the domain used for all labels and annotations for this resource
	BuildDomain = "build.shipwright.io"

	// LabelBuild is a label key for defining the build name
	LabelBuild = BuildDomain + "/name"

	// LabelBuildGeneration is a label key for defining the build generation
	LabelBuildGeneration = BuildDomain + "/generation"

	// AnnotationBuildRunDeletion is a label key for enabling/disabling the BuildRun deletion
	AnnotationBuildRunDeletion = BuildDomain + "/build-run-deletion"

	// AnnotationBuildRefSecret is an annotation that tells the Build Controller to reconcile on
	// events of the secret only if is referenced by a Build in the same namespace
	AnnotationBuildRefSecret = BuildDomain + "/referenced.secret"

	// AnnotationBuildVerifyRepository tells the Build Controller to check a remote repository. If the annotation is not set
	// or has a value of 'true', the controller triggers the validation. A value of 'false' means the controller
	// will bypass checking the remote repository.
	AnnotationBuildVerifyRepository = BuildDomain + "/verify.repository"
)
View Source 
const (
	// OutputImageZeroTimestamp indicates that the UNIX timestamp 0 is to be used
	OutputImageZeroTimestamp = "Zero"

	// OutputImageSourceTimestamp indicates that the timestamp of the respective source it to be used
	OutputImageSourceTimestamp = "SourceTimestamp"

	// OutputImageBuildTimestamp indicates that the current timestamp of the build run itself is to be used
	OutputImageBuildTimestamp = "BuildTimestamp"
)
View Source 
const (
	// BuildRunDomain is the domain used for all labels and annotations for this resource
	BuildRunDomain = "buildrun.shipwright.io"

	// LabelBuildRun is a label key for BuildRuns to define the name of the BuildRun
	LabelBuildRun = BuildRunDomain + "/name"

	// LabelBuildRunGeneration is a label key for BuildRuns to define the generation
	LabelBuildRunGeneration = BuildRunDomain + "/generation"
)
View Source 
const (
	// BuildRunStateCancel indicates that the user wants to cancel the BuildRun,
	// if not already canceled or terminated
	BuildRunStateCancel = "BuildRunCanceled"

	// BuildRunStatePodEvicted indicates that if the pods got evicted
	// due to some reason. (Probably ran out of ephemeral storage)
	BuildRunStatePodEvicted = "PodEvicted"
)
View Source 
const (
	// BuildStrategyDomain is the domain used for all labels and annotations for this resource
	BuildStrategyDomain = "buildstrategy.shipwright.io"

	// LabelBuildStrategyName is a label key for defining the build strategy name
	LabelBuildStrategyName = BuildStrategyDomain + "/name"

	// LabelBuildStrategyGeneration is a label key for defining the build strategy generation
	LabelBuildStrategyGeneration = BuildStrategyDomain + "/generation"
)
View Source 
const (
	// ClusterBuildStrategyDomain is the domain used for all labels and annotations for this resource
	ClusterBuildStrategyDomain = "clusterbuildstrategy.shipwright.io"

	// LabelClusterBuildStrategyName is a label key for defining the cluster build strategy name
	LabelClusterBuildStrategyName = ClusterBuildStrategyDomain + "/name"

	// LabelClusterBuildStrategyGeneration is a label key for defining the cluster build strategy generation
	LabelClusterBuildStrategyGeneration = ClusterBuildStrategyDomain + "/generation"
)

Variables

View Source 
var (
	// SchemeGroupVersion is group version used to register these objects
	SchemeGroupVersion = schema.GroupVersion{Group: "shipwright.io", Version: "v1alpha1"}

	// SchemeBuilder is used to add go types to the GroupVersionKind scheme
	SchemeBuilder = &scheme.Builder{GroupVersion: SchemeGroupVersion}

	// AddToScheme is used in the generated kube code
	AddToScheme = SchemeBuilder.AddToScheme
)

Functions

func ConditionStatusPtr added in v0.9.0 

func ConditionStatusPtr(s corev1.ConditionStatus) *corev1.ConditionStatus

ConditionStatusPtr returns a pointer to the passed ConditionStatus.

func IsLocalCopyType added in v0.12.0 

func IsLocalCopyType(sources []BuildSource) (int, bool)

IsLocalCopyType tells if we have an entry of the type local

func Kind added in v0.4.0 

func Kind(kind string) schema.GroupKind

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

func Resource added in v0.4.0 

func Resource(resource string) schema.GroupResource

Resource takes an unqualified resource and returns a Group qualified GroupResource

Types

type Build 

type Build struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   BuildSpec   `json:"spec"`
	Status BuildStatus `json:"status,omitempty"`
}

Build is the Schema representing a Build definition +kubebuilder:subresource:status +kubebuilder:resource:path=builds,scope=Namespaced +kubebuilder:printcolumn:name="Registered",type="string",JSONPath=".status.registered",description="The register status of the Build" +kubebuilder:printcolumn:name="Reason",type="string",JSONPath=".status.reason",description="The reason of the registered Build, either an error or succeed message" +kubebuilder:printcolumn:name="BuildStrategyKind",type="string",JSONPath=".spec.strategy.kind",description="The BuildStrategy type which is used for this Build" +kubebuilder:printcolumn:name="BuildStrategyName",type="string",JSONPath=".spec.strategy.name",description="The BuildStrategy name which is used for this Build" +kubebuilder:printcolumn:name="CreationTime",type="date",JSONPath=".metadata.creationTimestamp",description="The create time of this Build"

func (*Build) DeepCopy 

func (in *Build) DeepCopy() *Build

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Build.

func (*Build) DeepCopyInto 

func (in *Build) DeepCopyInto(out *Build)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*Build) DeepCopyObject 

func (in *Build) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type BuildList 

type BuildList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Build `json:"items"`
}

BuildList contains a list of Build

func (*BuildList) DeepCopy 

func (in *BuildList) DeepCopy() *BuildList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildList.

func (*BuildList) DeepCopyInto 

func (in *BuildList) DeepCopyInto(out *BuildList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*BuildList) DeepCopyObject 

func (in *BuildList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type BuildReason added in v0.3.0 

type BuildReason string

BuildReason is a type used for populating the Build Status.Reason field 

const (
	// SucceedStatus indicates that all validations Succeeded
	SucceedStatus BuildReason = "Succeeded"
	// BuildStrategyNotFound indicates that a namespaced-scope strategy was not found in the namespace
	BuildStrategyNotFound BuildReason = "BuildStrategyNotFound"
	// ClusterBuildStrategyNotFound indicates that a cluster-scope strategy was not found
	ClusterBuildStrategyNotFound BuildReason = "ClusterBuildStrategyNotFound"
	// SetOwnerReferenceFailed indicates that setting ownerReferences between a Build and a BuildRun failed
	SetOwnerReferenceFailed BuildReason = "SetOwnerReferenceFailed"
	// SpecSourceSecretRefNotFound indicates the referenced secret in source is missing
	SpecSourceSecretRefNotFound BuildReason = "SpecSourceSecretRefNotFound"
	// SpecOutputSecretRefNotFound indicates the referenced secret in output is missing
	SpecOutputSecretRefNotFound BuildReason = "SpecOutputSecretRefNotFound"
	// SpecBuilderSecretRefNotFound indicates the referenced secret in builder is missing
	SpecBuilderSecretRefNotFound BuildReason = "SpecBuilderSecretRefNotFound"
	// MultipleSecretRefNotFound indicates that multiple secrets are missing
	MultipleSecretRefNotFound BuildReason = "MultipleSecretRefNotFound"
	// SpecEnvNameCanNotBeBlank indicates that the name for an environment variable is blank
	SpecEnvNameCanNotBeBlank BuildReason = "SpecEnvNameCanNotBeBlank"
	// SpecEnvOnlyOneOfValueOrValueFromMustBeSpecified indicates that both value and valueFrom were specified
	SpecEnvOnlyOneOfValueOrValueFromMustBeSpecified BuildReason = "SpecEnvOnlyOneOfValueOrValueFromMustBeSpecified"
	// RuntimePathsCanNotBeEmpty indicates that the spec.runtime feature is used but the paths were not specified
	RuntimePathsCanNotBeEmpty BuildReason = "RuntimePathsCanNotBeEmpty"
	// RestrictedParametersInUse indicates the definition of reserved shipwright parameters
	RestrictedParametersInUse BuildReason = "RestrictedParametersInUse"
	// WrongParameterValueType indicates that a single value was provided for an array parameter, or vice-versa
	WrongParameterValueType BuildReason = "WrongParameterValueType"
	// UndefinedParameter indicates the definition of param that was not defined in the strategy parameters
	UndefinedParameter BuildReason = "UndefinedParameter"
	// InconsistentParameterValues indicates that parameter values have more than one of configMapValue, secretValue, or value set
	InconsistentParameterValues BuildReason = "InconsistentParameterValues"
	// EmptyArrayItemParameterValues indicates that array parameters contain an item where none of configMapValue, secretValue, or value is set
	EmptyArrayItemParameterValues BuildReason = "EmptyArrayItemParameterValues"
	// IncompleteConfigMapValueParameterValues indicates that a configMapValue is specified where the name or the key is empty
	IncompleteConfigMapValueParameterValues BuildReason = "IncompleteConfigMapValueParameterValues"
	// IncompleteSecretValueParameterValues indicates that a secretValue is specified where the name or the key is empty
	IncompleteSecretValueParameterValues BuildReason = "IncompleteSecretValueParameterValues"
	// RemoteRepositoryUnreachable indicates the referenced repository is unreachable
	RemoteRepositoryUnreachable BuildReason = "RemoteRepositoryUnreachable"
	// BuildNameInvalid indicates the build name is invalid
	BuildNameInvalid BuildReason = "BuildNameInvalid"
	// VolumeDoesNotExist indicates that volume referenced by the Build does not exist, therefore Build cannot be run
	VolumeDoesNotExist BuildReason = "VolumeDoesNotExist"
	// VolumeNotOverridable indicates that volume defined by build is not set as overridable in the strategy
	VolumeNotOverridable BuildReason = "VolumeNotOverridable"
	// UndefinedVolume indicates that volume defined by build is not found in the strategy
	UndefinedVolume BuildReason = "UndefinedVolume"
	// TriggerNameCanNotBeBlank indicates the trigger condition does not have a name
	TriggerNameCanNotBeBlank BuildReason = "TriggerNameCanNotBeBlank"
	// TriggerInvalidType indicates the trigger type is invalid
	TriggerInvalidType BuildReason = "TriggerInvalidType"
	// TriggerInvalidGitHubWebHook indicates the trigger type GitHub is invalid
	TriggerInvalidGitHubWebHook BuildReason = "TriggerInvalidGitHubWebHook"
	// TriggerInvalidImage indicates the trigger type Image is invalid
	TriggerInvalidImage BuildReason = "TriggerInvalidImage"
	// TriggerInvalidPipeline indicates the trigger type Pipeline is invalid
	TriggerInvalidPipeline BuildReason = "TriggerInvalidPipeline"

	// AllValidationsSucceeded indicates a Build was successfully validated
	AllValidationsSucceeded = "all validations succeeded"
)

func BuildReasonPtr added in v0.9.0 

func BuildReasonPtr(s BuildReason) *BuildReason

BuildReasonPtr returns a pointer to the passed BuildReason.

type BuildRef 

type BuildRef struct {
	// Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
	Name string `json:"name"`
	// API version of the referent
	// +optional
	APIVersion *string `json:"apiVersion,omitempty"`
}

BuildRef can be used to refer to a specific instance of a Build.

func (*BuildRef) DeepCopy 

func (in *BuildRef) DeepCopy() *BuildRef

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildRef.

func (*BuildRef) DeepCopyInto 

func (in *BuildRef) DeepCopyInto(out *BuildRef)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildRetention added in v0.9.0 

type BuildRetention struct {
	// FailedLimit defines the maximum number of failed buildruns that should exist.
	//
	// +optional
	// +kubebuilder:validation:Minimum=1
	FailedLimit *uint `json:"failedLimit,omitempty"`
	// SucceededLimit defines the maximum number of succeeded buildruns that should exist.
	//
	// +optional
	// +kubebuilder:validation:Minimum=1
	SucceededLimit *uint `json:"succeededLimit,omitempty"`
	// TTLAfterFailed defines the maximum duration of time the failed buildrun should exist.
	//
	// +optional
	// +kubebuilder:validation:Format=duration
	TTLAfterFailed *metav1.Duration `json:"ttlAfterFailed,omitempty"`
	// TTLAfterSucceeded defines the maximum duration of time the succeeded buildrun should exist.
	//
	// +optional
	// +kubebuilder:validation:Format=duration
	TTLAfterSucceeded *metav1.Duration `json:"ttlAfterSucceeded,omitempty"`
}

BuildRetention struct for buildrun cleanup

func (*BuildRetention) DeepCopy added in v0.9.0 

func (in *BuildRetention) DeepCopy() *BuildRetention

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildRetention.

func (*BuildRetention) DeepCopyInto added in v0.9.0 

func (in *BuildRetention) DeepCopyInto(out *BuildRetention)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildRun 

type BuildRun struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   BuildRunSpec   `json:"spec"`
	Status BuildRunStatus `json:"status,omitempty"`
}

BuildRun is the Schema representing an instance of build execution +kubebuilder:subresource:status +kubebuilder:resource:path=buildruns,scope=Namespaced,shortName=br;brs +kubebuilder:printcolumn:name="Succeeded",type="string",JSONPath=".status.conditions[?(@.type==\"Succeeded\")].status",description="The Succeeded status of the BuildRun" +kubebuilder:printcolumn:name="Reason",type="string",JSONPath=".status.conditions[?(@.type==\"Succeeded\")].reason",description="The Succeeded reason of the BuildRun" +kubebuilder:printcolumn:name="StartTime",type="date",JSONPath=".status.startTime",description="The start time of this BuildRun" +kubebuilder:printcolumn:name="CompletionTime",type="date",JSONPath=".status.completionTime",description="The completion time of this BuildRun"

func (*BuildRun) DeepCopy 

func (in *BuildRun) DeepCopy() *BuildRun

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildRun.

func (*BuildRun) DeepCopyInto 

func (in *BuildRun) DeepCopyInto(out *BuildRun)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*BuildRun) DeepCopyObject 

func (in *BuildRun) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

func (*BuildRun) HasStarted added in v0.6.0 

func (br *BuildRun) HasStarted() bool

HasStarted returns true if the BuildRun has a valid start time set in its status.

func (*BuildRun) IsCanceled added in v0.6.0 

func (br *BuildRun) IsCanceled() bool

IsCanceled returns true if the BuildRun's spec status is set to BuildRunCanceled state.

func (*BuildRun) IsDone added in v0.6.0 

func (br *BuildRun) IsDone() bool

IsDone returns true if the BuildRun's status indicates that it is done.

func (*BuildRun) IsSuccessful added in v0.6.0 

func (br *BuildRun) IsSuccessful() bool

IsSuccessful returns true if the BuildRun's status indicates that it is done.

type BuildRunList 

type BuildRunList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []BuildRun `json:"items"`
}

BuildRunList contains a list of BuildRun

func (*BuildRunList) DeepCopy 

func (in *BuildRunList) DeepCopy() *BuildRunList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildRunList.

func (*BuildRunList) DeepCopyInto 

func (in *BuildRunList) DeepCopyInto(out *BuildRunList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*BuildRunList) DeepCopyObject 

func (in *BuildRunList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type BuildRunRequestedState added in v0.6.0 

type BuildRunRequestedState string

BuildRunRequestedState defines the buildrun state the user can provide to override whatever is the current state.

func BuildRunRequestedStatePtr added in v0.9.0 

func BuildRunRequestedStatePtr(s BuildRunRequestedState) *BuildRunRequestedState

BuildRunRequestedStatePtr returns a pointer to the passed BuildRunRequestedState.

type BuildRunRetention added in v0.9.0 

type BuildRunRetention struct {
	// TTLAfterFailed defines the maximum duration of time the failed buildrun should exist.
	//
	// +optional
	// +kubebuilder:validation:Format=duration
	TTLAfterFailed *metav1.Duration `json:"ttlAfterFailed,omitempty"`
	// TTLAfterSucceeded defines the maximum duration of time the succeeded buildrun should exist.
	//
	// +optional
	// +kubebuilder:validation:Format=duration
	TTLAfterSucceeded *metav1.Duration `json:"ttlAfterSucceeded,omitempty"`
}

BuildRunRetention struct for buildrun cleanup

func (*BuildRunRetention) DeepCopy added in v0.9.0 

func (in *BuildRunRetention) DeepCopy() *BuildRunRetention

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildRunRetention.

func (*BuildRunRetention) DeepCopyInto added in v0.9.0 

func (in *BuildRunRetention) DeepCopyInto(out *BuildRunRetention)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildRunSpec 

type BuildRunSpec struct {
	// BuildSpec refers to an embedded build specification
	//
	// +optional
	BuildSpec *BuildSpec `json:"buildSpec,omitempty"`

	// BuildRef refers to the Build
	//
	// +optional
	BuildRef *BuildRef `json:"buildRef,omitempty"`

	// Sources slice of BuildSource, defining external build artifacts complementary to VCS
	// (`.spec.source`) data.
	//
	// +optional
	Sources []BuildSource `json:"sources,omitempty"`

	// ServiceAccount refers to the kubernetes serviceaccount
	// which is used for resource control.
	// Default serviceaccount will be set if it is empty
	//
	// +optional
	ServiceAccount *ServiceAccount `json:"serviceAccount,omitempty"`

	// Timeout defines the maximum run time of this BuildRun.
	//
	// +optional
	// +kubebuilder:validation:Format=duration
	Timeout *metav1.Duration `json:"timeout,omitempty"`

	// Params is a list of key/value that could be used
	// to set strategy parameters
	//
	// +optional
	ParamValues []ParamValue `json:"paramValues,omitempty"`

	// Output refers to the location where the generated
	// image would be pushed to. It will overwrite the output image in build spec
	//
	// +optional
	Output *Image `json:"output,omitempty"`

	// State is used for canceling a buildrun (and maybe more later on).
	//
	// +optional
	State *BuildRunRequestedState `json:"state,omitempty"`

	// Env contains additional environment variables that should be passed to the build container
	//
	// +optional
	Env []corev1.EnvVar `json:"env,omitempty"`

	// Contains information about retention params
	// +optional
	Retention *BuildRunRetention `json:"retention,omitempty"`

	// Volumes contains volume Overrides of the BuildStrategy volumes in case those are allowed
	// to be overridden. Must only contain volumes that exist in the corresponding BuildStrategy
	// +optional
	Volumes []BuildVolume `json:"volumes,omitempty"`
}

BuildRunSpec defines the desired state of BuildRun

func (*BuildRunSpec) BuildName added in v0.9.0 

func (buildrunSpec *BuildRunSpec) BuildName() string

BuildName returns the name of the associated build, which can be a referened build resource or an embedded build specification

func (*BuildRunSpec) DeepCopy 

func (in *BuildRunSpec) DeepCopy() *BuildRunSpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildRunSpec.

func (*BuildRunSpec) DeepCopyInto 

func (in *BuildRunSpec) DeepCopyInto(out *BuildRunSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildRunStatus 

type BuildRunStatus struct {
	// Sources holds the results emitted from the step definition
	// of different sources
	//
	// +optional
	Sources []SourceResult `json:"sources,omitempty"`

	// Output holds the results emitted from step definition of an output
	//
	// +optional
	Output *Output `json:"output,omitempty"`

	// Conditions holds the latest available observations of a resource's current state.
	Conditions Conditions `json:"conditions,omitempty"`

	// LatestTaskRunRef is the name of the TaskRun responsible for executing this BuildRun.
	//
	// TODO: This should be called something like "TaskRunName"
	//
	// +optional
	LatestTaskRunRef *string `json:"latestTaskRunRef,omitempty"`

	// StartTime is the time the build is actually started.
	// +optional
	StartTime *metav1.Time `json:"startTime,omitempty"`

	// CompletionTime is the time the build completed.
	// +optional
	CompletionTime *metav1.Time `json:"completionTime,omitempty"`

	// BuildSpec is the Build Spec of this BuildRun.
	// +optional
	BuildSpec *BuildSpec `json:"buildSpec,omitempty"`

	// Deprecated: FailedAt points to the resource where the BuildRun failed
	// +optional
	FailedAt *FailedAt `json:"failedAt,omitempty"`

	// FailureDetails contains error details that are collected and surfaced from TaskRun
	// +optional
	FailureDetails *FailureDetails `json:"failureDetails,omitempty"`
}

BuildRunStatus defines the observed state of BuildRun

func (*BuildRunStatus) DeepCopy 

func (in *BuildRunStatus) DeepCopy() *BuildRunStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildRunStatus.

func (*BuildRunStatus) DeepCopyInto 

func (in *BuildRunStatus) DeepCopyInto(out *BuildRunStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*BuildRunStatus) GetCondition added in v0.2.0 

func (brs *BuildRunStatus) GetCondition(t Type) *Condition

GetCondition returns a condition based on a type from a list of Conditions

func (*BuildRunStatus) IsFailed added in v0.4.0 

func (brs *BuildRunStatus) IsFailed(t Type) bool

IsFailed returns a condition with a False Status based on a type from a list of Conditions.

func (*BuildRunStatus) SetCondition added in v0.2.0 

func (brs *BuildRunStatus) SetCondition(condition *Condition)

SetCondition updates a list of conditions with the provided condition

type BuildSource added in v0.5.0 

type BuildSource struct {
	// Name instance entry.
	Name string `json:"name"`

	// Type is the BuildSource qualifier, the type of the data-source.
	//
	// +optional
	Type BuildSourceType `json:"type,omitempty"`

	// Timeout how long the BuildSource execution must take.
	//
	// +optional
	Timeout *metav1.Duration `json:"timeout,omitempty"`

	// URL remote artifact location.
	//
	// +optional
	URL string `json:"url,omitempty"`
}

BuildSource remote artifact definition, also known as "sources". Simple "name" and "url" pairs, initially without "credentials" (authentication) support yet.

func (*BuildSource) DeepCopy added in v0.5.0 

func (in *BuildSource) DeepCopy() *BuildSource

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildSource.

func (*BuildSource) DeepCopyInto added in v0.5.0 

func (in *BuildSource) DeepCopyInto(out *BuildSource)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildSourceType added in v0.5.0 

type BuildSourceType string

BuildSourceType enumerates build source type names. 

const HTTP BuildSourceType = "HTTP"

HTTP defines a (HTTP) remote artifact, which will be downloaded into the build POD, right before the build process starts. Represents a remote dependency.

NOTICE: HTTP artifact downloads are deprecated. This feature will be removed in a future release. 

const LocalCopy BuildSourceType = "LocalCopy"

LocalCopy represents a alternative build workflow that instead of `git clone` the repository, it employs the data uploaded by the user, streamed directly into the POD.

type BuildSpec 

type BuildSpec struct {
	// Source refers to the Git repository containing the
	// source code to be built.
	Source Source `json:"source"`

	// Sources slice of BuildSource, defining external build artifacts complementary to VCS
	// (`.spec.source`) data.
	//
	// +optional
	//
	// NOTICE: Multiple sources in a build are deprecated. This feature will be removed in a future release.
	Sources []BuildSource `json:"sources,omitempty"`

	// Trigger defines the scenarios where a new build should be triggered.
	//
	// +optional
	Trigger *Trigger `json:"trigger,omitempty"`

	// Strategy references the BuildStrategy to use to build the container
	// image.
	Strategy Strategy `json:"strategy"`

	// Builder refers to the image containing the build tools inside which
	// the source code would be built.
	//
	// NOTICE: Builder is deprecated, and will be removed in a future release.
	// Build strategies which rely on "builder" should provide an equivalent parameter instead.
	//
	// +optional
	Builder *Image `json:"builder,omitempty"`

	// Dockerfile is the path to the Dockerfile to be used for
	// build strategies which bank on the Dockerfile for building
	// an image.
	//
	// NOTICE: Dockerfile is deprecated, and will be removed in a future release.
	// Build strategies which rely on "dockerfile" should provide an equivalent parameter instead.
	//
	// +optional
	Dockerfile *string `json:"dockerfile,omitempty"`

	// Params is a list of key/value that could be used
	// to set strategy parameters
	//
	// +optional
	ParamValues []ParamValue `json:"paramValues,omitempty"`

	// Output refers to the location where the built image would be pushed.
	Output Image `json:"output"`

	// Timeout defines the maximum amount of time the Build should take to execute.
	//
	// +optional
	// +kubebuilder:validation:Format=duration
	Timeout *metav1.Duration `json:"timeout,omitempty"`

	// Env contains additional environment variables that should be passed to the build container
	// +optional
	Env []corev1.EnvVar `json:"env,omitempty"`

	// Contains information about retention params
	//
	// +optional
	Retention *BuildRetention `json:"retention,omitempty"`

	// Volumes contains volume Overrides of the BuildStrategy volumes in case those are allowed
	// to be overridden. Must only contain volumes that exist in the corresponding BuildStrategy
	// +optional
	Volumes []BuildVolume `json:"volumes,omitempty"`
}

BuildSpec defines the desired state of Build

func (*BuildSpec) DeepCopy 

func (in *BuildSpec) DeepCopy() *BuildSpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildSpec.

func (*BuildSpec) DeepCopyInto 

func (in *BuildSpec) DeepCopyInto(out *BuildSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*BuildSpec) StrategyName added in v0.4.0 

func (buildSpec *BuildSpec) StrategyName() string

StrategyName returns the name of the configured strategy, or 'undefined' in case the strategy is nil (not set)

type BuildStatus 

type BuildStatus struct {
	// The Register status of the Build
	// +optional
	Registered *corev1.ConditionStatus `json:"registered,omitempty"`

	// The reason of the registered Build, it's an one-word camelcase
	// +optional
	Reason *BuildReason `json:"reason,omitempty"`

	// The message of the registered Build, either an error or succeed message
	// +optional
	Message *string `json:"message,omitempty"`
}

BuildStatus defines the observed state of Build

NOTICE: This is deprecated and will be removed in a future release.

func (*BuildStatus) DeepCopy 

func (in *BuildStatus) DeepCopy() *BuildStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildStatus.

func (*BuildStatus) DeepCopyInto 

func (in *BuildStatus) DeepCopyInto(out *BuildStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildStep 

type BuildStep struct {
	corev1.Container `json:",inline"`
}

BuildStep defines a partial step that needs to run in container for building the image. If the build step declares a volumeMount, Shipwright will create an emptyDir volume mount for the named volume. Build steps which share the same named volume in the volumeMount will share the same underlying emptyDir volume. This behavior is deprecated, and will be removed when full volume support is added to build strategies as specified in SHIP-0022.

func (*BuildStep) DeepCopy 

func (in *BuildStep) DeepCopy() *BuildStep

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildStep.

func (*BuildStep) DeepCopyInto 

func (in *BuildStep) DeepCopyInto(out *BuildStep)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildStrategy 

type BuildStrategy struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   BuildStrategySpec   `json:"spec,omitempty"`
	Status BuildStrategyStatus `json:"status,omitempty"`
}

BuildStrategy is the Schema representing a strategy in the namespace scope to build images from source code. +kubebuilder:subresource:status +kubebuilder:resource:path=buildstrategies,scope=Namespaced,shortName=bs;bss

func (*BuildStrategy) DeepCopy 

func (in *BuildStrategy) DeepCopy() *BuildStrategy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildStrategy.

func (*BuildStrategy) DeepCopyInto 

func (in *BuildStrategy) DeepCopyInto(out *BuildStrategy)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*BuildStrategy) DeepCopyObject 

func (in *BuildStrategy) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

func (BuildStrategy) GetAnnotations added in v0.3.0 

func (s BuildStrategy) GetAnnotations() map[string]string

GetAnnotations returns the annotations of the build strategy

func (BuildStrategy) GetBuildSteps added in v0.2.0 

func (s BuildStrategy) GetBuildSteps() []BuildStep

GetBuildSteps returns the spec build steps of the build strategy

func (BuildStrategy) GetGeneration added in v0.2.0 

func (s BuildStrategy) GetGeneration() int64

GetGeneration returns the current generation sequence number of the build strategy resource

func (BuildStrategy) GetName added in v0.2.0 

func (s BuildStrategy) GetName() string

GetName returns the name of the build strategy

func (BuildStrategy) GetParameters added in v0.6.0 

func (s BuildStrategy) GetParameters() []Parameter

GetParameters returns the parameters defined by the build strategy

func (BuildStrategy) GetResourceLabels added in v0.2.0 

func (s BuildStrategy) GetResourceLabels() map[string]string

GetResourceLabels returns labels that define the build strategy name and generation to be used in labels map of a resource

func (BuildStrategy) GetSecurityContext added in v0.12.0 

func (s BuildStrategy) GetSecurityContext() *BuildStrategySecurityContext

GetSecurityContext returns the security context defined by the build strategy

func (BuildStrategy) GetVolumes added in v0.10.0 

func (s BuildStrategy) GetVolumes() []BuildStrategyVolume

GetVolumes returns the volumes defined by the build strategy

type BuildStrategyKind 

type BuildStrategyKind string

BuildStrategyKind defines the type of BuildStrategy used by the build. 

const (
	// NamespacedBuildStrategyKind indicates that the buildstrategy type has a namespaced scope.
	NamespacedBuildStrategyKind BuildStrategyKind = "BuildStrategy"

	// ClusterBuildStrategyKind indicates that buildstrategy type has a cluster scope.
	ClusterBuildStrategyKind BuildStrategyKind = "ClusterBuildStrategy"
)

type BuildStrategyList 

type BuildStrategyList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []BuildStrategy `json:"items"`
}

BuildStrategyList contains a list of BuildStrategy

func (*BuildStrategyList) DeepCopy 

func (in *BuildStrategyList) DeepCopy() *BuildStrategyList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildStrategyList.

func (*BuildStrategyList) DeepCopyInto 

func (in *BuildStrategyList) DeepCopyInto(out *BuildStrategyList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*BuildStrategyList) DeepCopyObject 

func (in *BuildStrategyList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type BuildStrategySecurityContext added in v0.12.0 

type BuildStrategySecurityContext struct {

	// The UID to run the entrypoint of the container process.
	// Defaults to user specified in image metadata if unspecified.
	// Can be overwritten by the security context on the step level.
	RunAsUser int64 `json:"runAsUser"`

	// The GID to run the entrypoint of the container process.
	// Defaults to group specified in image metadata if unspecified.
	// Can be overwritten by the security context on the step level.
	RunAsGroup int64 `json:"runAsGroup"`
}

BuildStrategySecurityContext defines a UID and GID for the build that is to be used for the build strategy steps as well as for shipwright-managed steps such as the source retrieval, or the image processing. The value can be overwritten on the steps for the strategy steps. If omitted, then UID and GID from the Shipwright configuration will be used for the shipwright-managed steps.

func (*BuildStrategySecurityContext) DeepCopy added in v0.12.0 

func (in *BuildStrategySecurityContext) DeepCopy() *BuildStrategySecurityContext

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildStrategySecurityContext.

func (*BuildStrategySecurityContext) DeepCopyInto added in v0.12.0 

func (in *BuildStrategySecurityContext) DeepCopyInto(out *BuildStrategySecurityContext)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildStrategySpec 

type BuildStrategySpec struct {
	BuildSteps      []BuildStep                   `json:"buildSteps,omitempty"`
	Parameters      []Parameter                   `json:"parameters,omitempty"`
	SecurityContext *BuildStrategySecurityContext `json:"securityContext,omitempty"`
	Volumes         []BuildStrategyVolume         `json:"volumes,omitempty"`
}

BuildStrategySpec defines the desired state of BuildStrategy

func (*BuildStrategySpec) DeepCopy 

func (in *BuildStrategySpec) DeepCopy() *BuildStrategySpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildStrategySpec.

func (*BuildStrategySpec) DeepCopyInto 

func (in *BuildStrategySpec) DeepCopyInto(out *BuildStrategySpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildStrategyStatus 

type BuildStrategyStatus struct {
}

BuildStrategyStatus defines the observed state of BuildStrategy

func (*BuildStrategyStatus) DeepCopy 

func (in *BuildStrategyStatus) DeepCopy() *BuildStrategyStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildStrategyStatus.

func (*BuildStrategyStatus) DeepCopyInto 

func (in *BuildStrategyStatus) DeepCopyInto(out *BuildStrategyStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildStrategyVolume added in v0.10.0 

type BuildStrategyVolume struct {
	// Indicates that this Volume can be overridden in a Build or BuildRun.
	// Defaults to false
	// +optional
	Overridable *bool `json:"overridable,omitempty"`

	// Name of the Build Volume
	// +required
	Name string `json:"name"`

	// Description of the Build Volume
	// +optional
	Description *string `json:"description,omitempty"`

	// Represents the source of a volume to mount
	// +required
	corev1.VolumeSource `json:",inline"`
}

BuildStrategyVolume is a volume that will be mounted in build pod during build step of the Build Strategy

func (*BuildStrategyVolume) DeepCopy added in v0.10.0 

func (in *BuildStrategyVolume) DeepCopy() *BuildStrategyVolume

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildStrategyVolume.

func (*BuildStrategyVolume) DeepCopyInto added in v0.10.0 

func (in *BuildStrategyVolume) DeepCopyInto(out *BuildStrategyVolume)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuildVolume added in v0.10.0 

type BuildVolume struct {
	// Name of the Build Volume
	// +required
	Name string `json:"name"`

	// Description of the Build Volume
	//
	// NOTICE: Description is deprecated, and will be removed in a future release.
	//
	// +optional
	Description *string `json:"description,omitempty"`

	// Represents the source of a volume to mount
	// +required
	corev1.VolumeSource `json:",inline"`
}

BuildVolume is a volume that will be mounted in build pod during build step

func (*BuildVolume) DeepCopy added in v0.10.0 

func (in *BuildVolume) DeepCopy() *BuildVolume

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BuildVolume.

func (*BuildVolume) DeepCopyInto added in v0.10.0 

func (in *BuildVolume) DeepCopyInto(out *BuildVolume)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BuilderStrategy added in v0.2.0 

type BuilderStrategy interface {
	GetAnnotations() map[string]string
	GetName() string
	GetGeneration() int64
	GetResourceLabels() map[string]string
	GetBuildSteps() []BuildStep
	GetParameters() []Parameter
	GetSecurityContext() *BuildStrategySecurityContext
	GetVolumes() []BuildStrategyVolume
}

BuilderStrategy defines the common elements of build strategies

type BundleContainer added in v0.6.0 

type BundleContainer struct {
	// Image reference, i.e. quay.io/org/image:tag
	Image string `json:"image"`

	// Prune specifies whether the image is suppose to be deleted. Allowed
	// values are 'Never' (no deletion) and `AfterPull` (removal after the
	// image was successfully pulled from the registry).
	//
	// If not defined, it defaults to 'Never'.
	//
	// +optional
	Prune *PruneOption `json:"prune,omitempty"`
}

BundleContainer describes the source code bundle container to pull

func (*BundleContainer) DeepCopy added in v0.6.0 

func (in *BundleContainer) DeepCopy() *BundleContainer

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BundleContainer.

func (*BundleContainer) DeepCopyInto added in v0.6.0 

func (in *BundleContainer) DeepCopyInto(out *BundleContainer)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type BundleSourceResult added in v0.6.0 

type BundleSourceResult struct {
	// Digest hold the image digest result
	Digest string `json:"digest,omitempty"`
}

BundleSourceResult holds the results emitted from the bundle source

func (*BundleSourceResult) DeepCopy added in v0.7.0 

func (in *BundleSourceResult) DeepCopy() *BundleSourceResult

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new BundleSourceResult.

func (*BundleSourceResult) DeepCopyInto added in v0.7.0 

func (in *BundleSourceResult) DeepCopyInto(out *BundleSourceResult)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ClusterBuildStrategy 

type ClusterBuildStrategy struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   BuildStrategySpec   `json:"spec,omitempty"`
	Status BuildStrategyStatus `json:"status,omitempty"`
}

ClusterBuildStrategy is the Schema representing a strategy in the cluster scope to build images from source code. +kubebuilder:subresource:status +kubebuilder:resource:path=clusterbuildstrategies,scope=Cluster,shortName=cbs;cbss

func (*ClusterBuildStrategy) DeepCopy 

func (in *ClusterBuildStrategy) DeepCopy() *ClusterBuildStrategy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ClusterBuildStrategy.

func (*ClusterBuildStrategy) DeepCopyInto 

func (in *ClusterBuildStrategy) DeepCopyInto(out *ClusterBuildStrategy)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*ClusterBuildStrategy) DeepCopyObject 

func (in *ClusterBuildStrategy) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

func (ClusterBuildStrategy) GetAnnotations added in v0.3.0 

func (s ClusterBuildStrategy) GetAnnotations() map[string]string

GetAnnotations returns the annotations of the build strategy

func (ClusterBuildStrategy) GetBuildSteps added in v0.2.0 

func (s ClusterBuildStrategy) GetBuildSteps() []BuildStep

GetBuildSteps returns the spec build steps of the build strategy

func (ClusterBuildStrategy) GetGeneration added in v0.2.0 

func (s ClusterBuildStrategy) GetGeneration() int64

GetGeneration returns the current generation sequence number of the build strategy resource

func (ClusterBuildStrategy) GetName added in v0.2.0 

func (s ClusterBuildStrategy) GetName() string

GetName returns the name of the build strategy

func (ClusterBuildStrategy) GetParameters added in v0.6.0 

func (s ClusterBuildStrategy) GetParameters() []Parameter

GetParameters returns the parameters defined by the build strategy

func (ClusterBuildStrategy) GetResourceLabels added in v0.2.0 

func (s ClusterBuildStrategy) GetResourceLabels() map[string]string

GetResourceLabels returns labels that define the build strategy name and generation to be used in labels map of a resource

func (ClusterBuildStrategy) GetSecurityContext added in v0.12.0 

func (s ClusterBuildStrategy) GetSecurityContext() *BuildStrategySecurityContext

GetSecurityContext returns the security context defined by the build strategy

func (ClusterBuildStrategy) GetVolumes added in v0.10.0 

func (s ClusterBuildStrategy) GetVolumes() []BuildStrategyVolume

GetVolumes returns the volumes defined by the build strategy

type ClusterBuildStrategyList 

type ClusterBuildStrategyList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ClusterBuildStrategy `json:"items"`
}

ClusterBuildStrategyList contains a list of ClusterBuildStrategy

func (*ClusterBuildStrategyList) DeepCopy 

func (in *ClusterBuildStrategyList) DeepCopy() *ClusterBuildStrategyList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ClusterBuildStrategyList.

func (*ClusterBuildStrategyList) DeepCopyInto 

func (in *ClusterBuildStrategyList) DeepCopyInto(out *ClusterBuildStrategyList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*ClusterBuildStrategyList) DeepCopyObject 

func (in *ClusterBuildStrategyList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type Condition added in v0.3.0 

type Condition struct {
	// Type of condition
	// +required
	Type Type `json:"type" description:"type of status condition"`

	// Status of the condition, one of True, False, Unknown.
	// +required
	Status corev1.ConditionStatus `json:"status" description:"status of the condition, one of True, False, Unknown"`

	// LastTransitionTime last time the condition transit from one status to another.
	LastTransitionTime metav1.Time `json:"lastTransitionTime" description:"last time the condition transit from one status to another"`

	// The reason for the condition last transition.
	Reason string `json:"reason" description:"one-word CamelCase reason for the condition's last transition"`

	// A human readable message indicating details about the transition.
	Message string `json:"message" description:"human-readable message indicating details about last transition"`
}

Condition defines the required fields for populating Build controllers Conditions

func (*Condition) DeepCopy added in v0.3.0 

func (in *Condition) DeepCopy() *Condition

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Condition.

func (*Condition) DeepCopyInto added in v0.3.0 

func (in *Condition) DeepCopyInto(out *Condition)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*Condition) GetMessage added in v0.3.0 

func (c *Condition) GetMessage() string

GetMessage returns the condition Message, it ensures that by getting the Message the call will not panic if the Condition is not present

func (*Condition) GetReason added in v0.3.0 

func (c *Condition) GetReason() string

GetReason returns the condition Reason, it ensures that by getting the Reason the call will not panic if the Condition is not present

func (*Condition) GetStatus added in v0.3.0 

func (c *Condition) GetStatus() corev1.ConditionStatus

GetStatus returns the condition Status, it ensures that by getting the Status the call will not panic if the Condition is not present

type Conditions added in v0.3.0 

type Conditions []Condition

Conditions defines a list of Condition

func (Conditions) DeepCopy added in v0.3.0 

func (in Conditions) DeepCopy() Conditions

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Conditions.

func (Conditions) DeepCopyInto added in v0.3.0 

func (in Conditions) DeepCopyInto(out *Conditions)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type FailedAt added in v0.3.0 

type FailedAt struct {
	Pod       string `json:"pod,omitempty"`
	Container string `json:"container,omitempty"`
}

FailedAt describes the location where the failure happened

func (*FailedAt) DeepCopy added in v0.3.0 

func (in *FailedAt) DeepCopy() *FailedAt

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FailedAt.

func (*FailedAt) DeepCopyInto added in v0.3.0 

func (in *FailedAt) DeepCopyInto(out *FailedAt)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type FailureDetails added in v0.8.0 

type FailureDetails struct {
	Reason   string    `json:"reason,omitempty"`
	Message  string    `json:"message,omitempty"`
	Location *FailedAt `json:"location,omitempty"`
}

FailureDetails describes an error while building images

func (*FailureDetails) DeepCopy added in v0.8.0 

func (in *FailureDetails) DeepCopy() *FailureDetails

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FailureDetails.

func (*FailureDetails) DeepCopyInto added in v0.8.0 

func (in *FailureDetails) DeepCopyInto(out *FailureDetails)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type GitHubEventName added in v0.11.0 

type GitHubEventName string

GitHubEventName set of WhenGitHub valid event names. 

const (
	// GitHubPullRequestEvent github pull-request event name.
	GitHubPullRequestEvent GitHubEventName = "PullRequest"

	// GitHubPushEvent git push webhook event name.
	GitHubPushEvent GitHubEventName = "Push"
)

type GitSourceResult added in v0.6.0 

type GitSourceResult struct {
	// CommitSha holds the commit sha of git source
	CommitSha string `json:"commitSha,omitempty"`

	// CommitAuthor holds the commit author of a git source
	CommitAuthor string `json:"commitAuthor,omitempty"`

	// BranchName holds the default branch name of the git source
	// this will be set only when revision is not specified in Build object
	BranchName string `json:"branchName,omitempty"`
}

GitSourceResult holds the results emitted from the git source

func (*GitSourceResult) DeepCopy added in v0.7.0 

func (in *GitSourceResult) DeepCopy() *GitSourceResult

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new GitSourceResult.

func (*GitSourceResult) DeepCopyInto added in v0.7.0 

func (in *GitSourceResult) DeepCopyInto(out *GitSourceResult)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type Image 

type Image struct {
	// Image is the reference of the image.
	Image string `json:"image"`

	// Insecure defines whether the registry is not secure
	//
	// +optional
	Insecure *bool `json:"insecure,omitempty"`

	// Credentials references a Secret that contains credentials to access
	// the image registry.
	//
	// +optional
	Credentials *corev1.LocalObjectReference `json:"credentials,omitempty"`

	// Annotations references the additional annotations to be applied on the image
	//
	// +optional
	Annotations map[string]string `json:"annotations,omitempty"`

	// Labels references the additional labels to be applied on the image
	//
	// +optional
	Labels map[string]string `json:"labels,omitempty"`

	// Timestamp references the optional image timestamp to be set, valid values are:
	// - "Zero", to set 00:00:00 UTC on 1 January 1970
	// - "SourceTimestamp", to set the source timestamp dereived from the input source
	// - "BuildTimestamp", to set the timestamp of the current build itself
	// - Parsable integer number defined as the epoch seconds
	// - or nil/empty to not set any specific timestamp
	//
	// +optional
	Timestamp *string `json:"timestamp,omitempty"`
}

Image refers to an container image with credentials

func (*Image) DeepCopy 

func (in *Image) DeepCopy() *Image

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Image.

func (*Image) DeepCopyInto 

func (in *Image) DeepCopyInto(out *Image)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ObjectKeyRef added in v0.8.0 

type ObjectKeyRef struct {

	// Name of the object
	// +required
	Name string `json:"name"`

	// Key inside the object
	// +required
	Key string `json:"key"`

	// An optional format to add pre- or suffix to the object value. For example 'KEY=${SECRET_VALUE}' or 'KEY=${CONFIGMAP_VALUE}' depending on the context.
	// +optional
	Format *string `json:"format"`
}

func (*ObjectKeyRef) DeepCopy added in v0.8.0 

func (in *ObjectKeyRef) DeepCopy() *ObjectKeyRef

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ObjectKeyRef.

func (*ObjectKeyRef) DeepCopyInto added in v0.8.0 

func (in *ObjectKeyRef) DeepCopyInto(out *ObjectKeyRef)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type Output added in v0.6.0 

type Output struct {
	// Digest holds the digest of output image
	Digest string `json:"digest,omitempty"`

	// Size holds the compressed size of output image
	Size int64 `json:"size,omitempty"`
}

Output holds the results emitted from the output step (build-and-push)

func (*Output) DeepCopy added in v0.7.0 

func (in *Output) DeepCopy() *Output

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Output.

func (*Output) DeepCopyInto added in v0.7.0 

func (in *Output) DeepCopyInto(out *Output)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ParamValue added in v0.6.0 

type ParamValue struct {

	// Inline the properties of a value
	// +optional
	*SingleValue `json:",inline"`

	// Name of the parameter
	// +required
	Name string `json:"name"`

	// Values of an array parameter
	// +optional
	Values []SingleValue `json:"values,omitempty"`
}

ParamValue is a key/value that populates a strategy parameter used in the execution of the strategy steps

func (*ParamValue) DeepCopy added in v0.6.0 

func (in *ParamValue) DeepCopy() *ParamValue

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ParamValue.

func (*ParamValue) DeepCopyInto added in v0.6.0 

func (in *ParamValue) DeepCopyInto(out *ParamValue)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type Parameter 

type Parameter struct {
	// Name of the parameter
	// +required
	Name string `json:"name"`

	// Description on the parameter purpose
	// +required
	Description string `json:"description"`

	// Type of the parameter. The possible types are "string" and "array",
	// and "string" is the default.
	// +optional
	Type ParameterType `json:"type,omitempty"`

	// Default value for a string parameter
	// +optional
	Default *string `json:"default,omitempty"`

	// Default values for an array parameter
	// +optional
	Defaults *[]string `json:"defaults"`
}

Parameter holds a name-description with a default value that allows strategy steps to be parameterize. Build users can set a value for parameter via the Build or BuildRun spec.paramValues object. +optional

func (*Parameter) DeepCopy 

func (in *Parameter) DeepCopy() *Parameter

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Parameter.

func (*Parameter) DeepCopyInto 

func (in *Parameter) DeepCopyInto(out *Parameter)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ParameterType added in v0.8.0 

type ParameterType string

ParameterType indicates the type of a parameter 

const (
	ParameterTypeString ParameterType = "string"
	ParameterTypeArray  ParameterType = "array"
)

Valid ParamTypes:

type PruneOption added in v0.9.0 

type PruneOption string

PruneOption defines the supported options for image pruning 

const (
	// Do not delete image after it was pulled
	PruneNever PruneOption = "Never"

	// Delete image after it was successfully pulled
	PruneAfterPull PruneOption = "AfterPull"
)

type ServiceAccount 

type ServiceAccount struct {
	// Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
	// +optional
	Name *string `json:"name,omitempty"`
	// If generates a new ServiceAccount for the build
	//
	// NOTICE: Generated ServiceAccounts are deprecated, and will be removed in a future release.
	// +optional
	Generate *bool `json:"generate,omitempty"`
}

ServiceAccount can be used to refer to a specific ServiceAccount.

func (*ServiceAccount) DeepCopy 

func (in *ServiceAccount) DeepCopy() *ServiceAccount

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceAccount.

func (*ServiceAccount) DeepCopyInto 

func (in *ServiceAccount) DeepCopyInto(out *ServiceAccount)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SingleValue added in v0.8.0 

type SingleValue struct {

	// The value of the parameter
	// +optional
	Value *string `json:"value"`

	// The ConfigMap value of the parameter
	// +optional
	ConfigMapValue *ObjectKeyRef `json:"configMapValue"`

	// The secret value of the parameter
	// +optional
	SecretValue *ObjectKeyRef `json:"secretValue"`
}

The value type contains the properties for a value, this allows for an easy extension in the future to support more kinds

func (*SingleValue) DeepCopy added in v0.8.0 

func (in *SingleValue) DeepCopy() *SingleValue

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SingleValue.

func (*SingleValue) DeepCopyInto added in v0.8.0 

func (in *SingleValue) DeepCopyInto(out *SingleValue)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type Source added in v0.4.0 

type Source struct {
	// URL describes the URL of the Git repository.
	//
	// +optional
	URL *string `json:"url,omitempty"`

	// BundleContainer
	//
	// +optional
	BundleContainer *BundleContainer `json:"bundleContainer,omitempty"`

	// Revision describes the Git revision (e.g., branch, tag, commit SHA,
	// etc.) to fetch.
	//
	// If not defined, it will fallback to the repository's default branch.
	//
	// +optional
	Revision *string `json:"revision,omitempty"`

	// ContextDir is a path to subfolder in the repo. Optional.
	//
	// +optional
	ContextDir *string `json:"contextDir,omitempty"`

	// Credentials references a Secret that contains credentials to access
	// the repository.
	//
	// +optional
	Credentials *corev1.LocalObjectReference `json:"credentials,omitempty"`
}

Source describes the Git source repository to fetch.

func (*Source) DeepCopy added in v0.4.0 

func (in *Source) DeepCopy() *Source

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Source.

func (*Source) DeepCopyInto added in v0.4.0 

func (in *Source) DeepCopyInto(out *Source)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SourceResult added in v0.6.0 

type SourceResult struct {
	// Name is the name of source
	Name string `json:"name"`

	// Git holds the results emitted from from the
	// step definition of a git source
	//
	// +optional
	Git *GitSourceResult `json:"git,omitempty"`

	// Bundle holds the results emitted from from the
	// step definition of bundle source
	//
	// +optional
	Bundle *BundleSourceResult `json:"bundle,omitempty"`

	// Timestamp holds the timestamp of the source, which
	// depends on the actual source type and could range from
	// being the commit timestamp or the fileystem timestamp
	// of the most recent source file in the working directory
	//
	// +optional
	Timestamp *metav1.Time `json:"timestamp,omitempty"`
}

SourceResult holds the results emitted from the different sources

func (*SourceResult) DeepCopy added in v0.7.0 

func (in *SourceResult) DeepCopy() *SourceResult

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SourceResult.

func (*SourceResult) DeepCopyInto added in v0.7.0 

func (in *SourceResult) DeepCopyInto(out *SourceResult)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type Strategy added in v0.4.0 

type Strategy struct {
	// Name of the referent; More info: http://kubernetes.io/docs/user-guide/identifiers#names
	Name string `json:"name"`

	// BuildStrategyKind indicates the kind of the buildstrategy, namespaced or cluster scoped.
	Kind *BuildStrategyKind `json:"kind,omitempty"`

	// API version of the referent
	// +optional
	APIVersion *string `json:"apiVersion,omitempty"`
}

Strategy can be used to refer to a specific instance of a buildstrategy. Copied from CrossVersionObjectReference: https://github.com/kubernetes/kubernetes/blob/169df7434155cbbc22f1532cba8e0a9588e29ad8/pkg/apis/autoscaling/types.go#L64

func (*Strategy) DeepCopy added in v0.4.0 

func (in *Strategy) DeepCopy() *Strategy

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Strategy.

func (*Strategy) DeepCopyInto added in v0.4.0 

func (in *Strategy) DeepCopyInto(out *Strategy)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type Trigger added in v0.11.0 

type Trigger struct {
	// When the list of scenarios when a new build should take place.
	When []TriggerWhen `json:"when,omitempty"`

	// SecretRef points to a local object carrying the secret token to validate webhook request.
	//
	// +optional
	SecretRef *corev1.LocalObjectReference `json:"secretRef,omitempty"`
}

Trigger represents the webhook trigger configuration for a Build.

func (*Trigger) DeepCopy added in v0.11.0 

func (in *Trigger) DeepCopy() *Trigger

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Trigger.

func (*Trigger) DeepCopyInto added in v0.11.0 

func (in *Trigger) DeepCopyInto(out *Trigger)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type TriggerType added in v0.11.0 

type TriggerType string

TriggerType set of TriggerWhen valid names. 

const (
	// GitHubWebHookTrigger GitHubWebHookTrigger trigger type name.
	GitHubWebHookTrigger TriggerType = "GitHub"

	// ImageTrigger Image trigger type name.
	ImageTrigger TriggerType = "Image"

	// PipelineTrigger Tekton Pipeline trigger type name.
	PipelineTrigger TriggerType = "Pipeline"
)

type TriggerWhen added in v0.11.0 

type TriggerWhen struct {
	// Name name or the short description of the trigger condition.
	Name string `json:"name"`

	// Type the event type
	Type TriggerType `json:"type"`

	// GitHub describes how to trigger builds based on GitHub (SCM) events.
	//
	// +optional
	GitHub *WhenGitHub `json:"github,omitempty"`

	// Image slice of image names where the event applies.
	//
	// +optional
	Image *WhenImage `json:"image,omitempty"`

	// ObjectRef describes how to match a foreign resource, either using the name or the label
	// selector, plus the current resource status.
	//
	// +optional
	ObjectRef *WhenObjectRef `json:"objectRef,omitempty"`
}

TriggerWhen a given scenario where the webhook trigger is applicable.

func (*TriggerWhen) DeepCopy added in v0.11.0 

func (in *TriggerWhen) DeepCopy() *TriggerWhen

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TriggerWhen.

func (*TriggerWhen) DeepCopyInto added in v0.11.0 

func (in *TriggerWhen) DeepCopyInto(out *TriggerWhen)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*TriggerWhen) GetBranches added in v0.11.0 

func (w *TriggerWhen) GetBranches(whenType TriggerType) []string

GetBranches return a slice of branch names based on the WhenTypeName informed.

type Type added in v0.3.0 

type Type string

Type used for defining the conditiont Type field flavour 

const (
	// Succeeded specifies that the resource has finished.
	// For resources that run to completion.
	Succeeded Type = "Succeeded"
)

type WhenGitHub added in v0.11.0 

type WhenGitHub struct {
	// Events GitHub event names.
	//
	// +kubebuilder:validation:MinItems=1
	Events []GitHubEventName `json:"events,omitempty"`

	// Branches slice of branch names where the event applies.
	//
	// +optional
	Branches []string `json:"branches,omitempty"`
}

WhenGitHub attributes to match GitHub events.

func (*WhenGitHub) DeepCopy added in v0.11.0 

func (in *WhenGitHub) DeepCopy() *WhenGitHub

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new WhenGitHub.

func (*WhenGitHub) DeepCopyInto added in v0.11.0 

func (in *WhenGitHub) DeepCopyInto(out *WhenGitHub)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type WhenImage added in v0.11.0 

type WhenImage struct {
	// Names fully qualified image names.
	//
	// +optional
	Names []string `json:"names,omitempty"`
}

WhenImage attributes to match Image events.

func (*WhenImage) DeepCopy added in v0.11.0 

func (in *WhenImage) DeepCopy() *WhenImage

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new WhenImage.

func (*WhenImage) DeepCopyInto added in v0.11.0 

func (in *WhenImage) DeepCopyInto(out *WhenImage)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type WhenObjectRef added in v0.11.0 

type WhenObjectRef struct {
	// Name target object name.
	//
	// +optional
	Name string `json:"name,omitempty"`

	// Status object status.
	Status []string `json:"status,omitempty"`

	// Selector label selector.
	//
	// +optional
	Selector map[string]string `json:"selector,omitempty"`
}

WhenObjectRef attributes to reference local Kubernetes objects.

func (*WhenObjectRef) DeepCopy added in v0.11.0 

func (in *WhenObjectRef) DeepCopy() *WhenObjectRef

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new WhenObjectRef.

func (*WhenObjectRef) DeepCopyInto added in v0.11.0 

func (in *WhenObjectRef) DeepCopyInto(out *WhenObjectRef)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

Source Files

View all Source files

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.