pipelinerun

Documentation

Index

• Constants
• Variables
• func GetAffinityAssistantName(pipelineWorkspaceName string, pipelineRunName string) string
• func NewController(opts *pipeline.Options, clock clock.PassiveClock) func(context.Context, configmap.Watcher) *controller.Impl
• type Reconciler
  • func (c *Reconciler) ReconcileKind(ctx context.Context, pr *v1.PipelineRun) pkgreconciler.Event

Constants

const (
	// TracerName is the name of the tracer
	TracerName = "PipelineRunReconciler"
	// SpanContextAnnotation is the name of the Annotation for storing SpanContext
	SpanContextAnnotation = "tekton.dev/pipelinerunSpanContext"
	// TaskRunSpanContextAnnotation is the name of the Annotation used for propogating SpanContext to TaskRun
	TaskRunSpanContextAnnotation = "tekton.dev/taskrunSpanContext"
)

const (
	// ReasonCouldntCreateOrUpdateAffinityAssistantStatefulSet indicates that a PipelineRun uses workspaces with PersistentVolumeClaim
	// as a volume source and expect an Assistant StatefulSet in AffinityAssistantPerWorkspace behavior, but couldn't create a StatefulSet.
	ReasonCouldntCreateOrUpdateAffinityAssistantStatefulSet = "ReasonCouldntCreateOrUpdateAffinityAssistantStatefulSet"
)

const (
	// TracerProviderName is the name of TraceProvider
	TracerProviderName = "pipelinerun-reconciler"
)

Variables

var (
	ErrPvcCreationFailed               = errors.New("PVC creation error")
	ErrAffinityAssistantCreationFailed = errors.New("Affinity Assistant creation error")
)

var (
	// ReasonCouldntGetPipeline indicates that the reason for the failure status is that the
	// associated Pipeline couldn't be retrieved
	ReasonCouldntGetPipeline = v1.PipelineRunReasonCouldntGetPipeline.String()
	// ReasonInvalidBindings indicates that the reason for the failure status is that the
	// PipelineResources bound in the PipelineRun didn't match those declared in the Pipeline
	ReasonInvalidBindings = v1.PipelineRunReasonInvalidBindings.String()
	// ReasonInvalidWorkspaceBinding indicates that a Pipeline expects a workspace but a
	// PipelineRun has provided an invalid binding.
	ReasonInvalidWorkspaceBinding = v1.PipelineRunReasonInvalidWorkspaceBinding.String()
	// ReasonInvalidTaskRunSpec indicates that PipelineRun.Spec.TaskRunSpecs[].PipelineTaskName is defined with
	// a not exist taskName in pipelineSpec.
	ReasonInvalidTaskRunSpec = v1.PipelineRunReasonInvalidTaskRunSpec.String()
	// ReasonParameterTypeMismatch indicates that the reason for the failure status is that
	// parameter(s) declared in the PipelineRun do not have the some declared type as the
	// parameters(s) declared in the Pipeline that they are supposed to override.
	ReasonParameterTypeMismatch = v1.PipelineRunReasonParameterTypeMismatch.String()
	// ReasonObjectParameterMissKeys indicates that the object param value provided from PipelineRun spec
	// misses some keys required for the object param declared in Pipeline spec.
	ReasonObjectParameterMissKeys = v1.PipelineRunReasonObjectParameterMissKeys.String()
	// ReasonParamArrayIndexingInvalid indicates that the use of param array indexing is not under correct api fields feature gate
	// or the array is out of bound.
	ReasonParamArrayIndexingInvalid = v1.PipelineRunReasonParamArrayIndexingInvalid.String()
	// ReasonCouldntGetTask indicates that the reason for the failure status is that the
	// associated Pipeline's Tasks couldn't all be retrieved
	ReasonCouldntGetTask = v1.PipelineRunReasonCouldntGetTask.String()
	// ReasonParameterMissing indicates that the reason for the failure status is that the
	// associated PipelineRun didn't provide all the required parameters
	ReasonParameterMissing = v1.PipelineRunReasonParameterMissing.String()
	// ReasonFailedValidation indicates that the reason for failure status is
	// that pipelinerun failed runtime validation
	ReasonFailedValidation = v1.PipelineRunReasonFailedValidation.String()
	// ReasonInvalidGraph indicates that the reason for the failure status is that the
	// associated Pipeline is an invalid graph (a.k.a wrong order, cycle, …)
	ReasonInvalidGraph = v1.PipelineRunReasonInvalidGraph.String()
	// ReasonCancelled indicates that a PipelineRun was cancelled.
	ReasonCancelled = v1.PipelineRunReasonCancelled.String()
	// ReasonPending indicates that a PipelineRun is pending.
	ReasonPending = v1.PipelineRunReasonPending.String()
	// ReasonCouldntCancel indicates that a PipelineRun was cancelled but attempting to update
	// all of the running TaskRuns as cancelled failed.
	ReasonCouldntCancel = v1.PipelineRunReasonCouldntCancel.String()
	// ReasonCouldntTimeOut indicates that a PipelineRun was timed out but attempting to update
	// all of the running TaskRuns as timed out failed.
	ReasonCouldntTimeOut = v1.PipelineRunReasonCouldntTimeOut.String()
	// ReasonInvalidMatrixParameterTypes indicates a matrix contains invalid parameter types
	ReasonInvalidMatrixParameterTypes = v1.PipelineRunReasonInvalidMatrixParameterTypes.String()
	// ReasonInvalidTaskResultReference indicates a task result was declared
	// but was not initialized by that task
	ReasonInvalidTaskResultReference = v1.PipelineRunReasonInvalidTaskResultReference.String()
	// ReasonRequiredWorkspaceMarkedOptional indicates an optional workspace
	// has been passed to a Task that is expecting a non-optional workspace
	ReasonRequiredWorkspaceMarkedOptional = v1.PipelineRunReasonRequiredWorkspaceMarkedOptional.String()
	// ReasonResolvingPipelineRef indicates that the PipelineRun is waiting for
	// its pipelineRef to be asynchronously resolved.
	ReasonResolvingPipelineRef = v1.PipelineRunReasonResolvingPipelineRef.String()
	// ReasonResourceVerificationFailed indicates that the pipeline fails the trusted resource verification,
	// it could be the content has changed, signature is invalid or public key is invalid
	ReasonResourceVerificationFailed = v1.PipelineRunReasonResourceVerificationFailed.String()
	// ReasonCreateRunFailed indicates that the pipeline fails to create the taskrun or other run resources
	ReasonCreateRunFailed = v1.PipelineRunReasonCreateRunFailed.String()
)

Aliased for backwards compatibility; do not add additional reasons here

Functions

func GetAffinityAssistantName

func GetAffinityAssistantName(pipelineWorkspaceName string, pipelineRunName string) string

GetAffinityAssistantName returns the Affinity Assistant name based on pipelineWorkspaceName and pipelineRunName

func NewController

func NewController(opts *pipeline.Options, clock clock.PassiveClock) func(context.Context, configmap.Watcher) *controller.Impl

NewController instantiates a new controller.Impl from knative.dev/pkg/controller

Types

type Reconciler

type Reconciler struct {
	KubeClientSet     kubernetes.Interface
	PipelineClientSet clientset.Interface
	Images            pipeline.Images
	Clock             clock.PassiveClock
	// contains filtered or unexported fields
}

Reconciler implements controller.Reconciler for Configuration resources.

func (*Reconciler) ReconcileKind

func (c *Reconciler) ReconcileKind(ctx context.Context, pr *v1.PipelineRun) pkgreconciler.Event

ReconcileKind compares the actual state with the desired, and attempts to converge the two. It then updates the Status block of the Pipeline Run resource with the current status of the resource.