resources

package
v0.0.0-...-4fc8c9b Latest Latest
Warning

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

 Go to latest Published: Nov 28, 2023 License: Apache-2.0 Imports: 26 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ApplyContexts 

func ApplyContexts(spec *v1.TaskSpec, taskName string, tr *v1.TaskRun) *v1.TaskSpec

ApplyContexts applies the substitution from $(context.(taskRun|task).*) with the specified values. Uses "" as a default if a value is not available.

func ApplyCredentialsPath 

func ApplyCredentialsPath(spec *v1.TaskSpec, path string) *v1.TaskSpec

ApplyCredentialsPath applies a substitution of the key $(credentials.path) with the path that credentials from annotated secrets are written to.

func ApplyParameters 

func ApplyParameters(spec *v1.TaskSpec, tr *v1.TaskRun, defaults ...v1.ParamSpec) *v1.TaskSpec

ApplyParameters applies the params from a TaskRun.Parameters to a TaskSpec

func ApplyReplacements 

func ApplyReplacements(spec *v1.TaskSpec, stringReplacements map[string]string, arrayReplacements map[string][]string, objectReplacements map[string]map[string]string) *v1.TaskSpec

ApplyReplacements replaces placeholders for declared parameters with the specified replacements.

func ApplyStepExitCodePath 

func ApplyStepExitCodePath(spec *v1.TaskSpec) *v1.TaskSpec

ApplyStepExitCodePath replaces the occurrences of exitCode path with the absolute tekton internal path Replace $(steps.<step-name>.exitCode.path) with pipeline.StepPath/<step-name>/exitCode

func ApplyTaskResults 

func ApplyTaskResults(spec *v1.TaskSpec) *v1.TaskSpec

ApplyTaskResults applies the substitution from values in results which are referenced in spec as subitems of the replacementStr.

func ApplyWorkspaces 

func ApplyWorkspaces(ctx context.Context, spec *v1.TaskSpec, declarations []v1.WorkspaceDeclaration, bindings []v1.WorkspaceBinding, vols map[string]corev1.Volume) *v1.TaskSpec

ApplyWorkspaces applies the substitution from paths that the workspaces in declarations mounted to, the volumes that bindings are realized with in the task spec and the PersistentVolumeClaim names for the workspaces.

func GetStepActionsData 

func GetStepActionsData(ctx context.Context, taskSpec v1.TaskSpec, taskRun *v1.TaskRun, tekton clientset.Interface, k8s kubernetes.Interface, requester remoteresource.Requester) ([]v1.Step, error)

GetStepActionsData extracts the StepActions and merges them with the inlined Step specification.

func GetTaskData 

func GetTaskData(ctx context.Context, taskRun *v1.TaskRun, getTask GetTask) (*resolutionutil.ResolvedObjectMeta, *v1.TaskSpec, error)

GetTaskData will retrieve the Task metadata and Spec associated with the provided TaskRun. This can come from a reference Task or from the TaskRun's metadata and embedded TaskSpec.

func GetTaskKind 

func GetTaskKind(taskrun *v1.TaskRun) v1.TaskKind

GetTaskKind returns the referenced Task kind (Task, ClusterTask, ...) if the TaskRun is using TaskRef.

func IsErrTransient 

func IsErrTransient(err error) bool

IsErrTransient returns true if an error returned by GetTask/GetStepAction is retryable.

func ValidateOutOfBoundArrayParams 

func ValidateOutOfBoundArrayParams(declarations v1.ParamSpecs, params v1.Params, arrayIndexingReferences sets.String) error

ValidateOutOfBoundArrayParams returns an error if the array indexing params are out of bounds, based on the param declarations, the parameters passed in at runtime, and the indexing references to array params from a task or pipeline spec. Example of arrayIndexingReferences: ["$(params.a-array-param[1])", "$(params.b-array-param[2])"]

func ValidateParamArrayIndex 

func ValidateParamArrayIndex(ts *v1.TaskSpec, params v1.Params) error

ValidateParamArrayIndex validates if the param reference to an array param is out of bound. error is returned when the array indexing reference is out of bound of the array param e.g. if a param reference of $(params.array-param[2]) and the array param is of length 2. - `params` are params from taskrun. - `ts` contains params declarations and references to array params.

Types

type GetStepAction 

type GetStepAction func(context.Context, string) (*v1alpha1.StepAction, *v1.RefSource, error)

GetStepAction is a function used to retrieve StepActions.

func GetStepActionFunc 

func GetStepActionFunc(tekton clientset.Interface, k8s kubernetes.Interface, requester remoteresource.Requester, tr *v1.TaskRun, step *v1.Step) GetStepAction

GetStepActionFunc is a factory function that will use the given Ref as context to return a valid GetStepAction function. It also requires a kubeclient, tektonclient, requester in case it needs to find that task in cluster or authorize against an external repository. It will figure out whether it needs to look in the cluster or in a remote location to fetch the reference.

type GetTask 

type GetTask func(context.Context, string) (*v1.Task, *v1.RefSource, *trustedresources.VerificationResult, error)

GetTask is a function used to retrieve Tasks. VerificationResult is the result from trusted resources if the feature is enabled.

func GetTaskFunc 

func GetTaskFunc(ctx context.Context, k8s kubernetes.Interface, tekton clientset.Interface, requester remoteresource.Requester,
	owner kmeta.OwnerRefable, tr *v1.TaskRef, trName string, namespace, saName string, verificationPolicies []*v1alpha1.VerificationPolicy) GetTask

GetTaskFunc is a factory function that will use the given TaskRef as context to return a valid GetTask function. It also requires a kubeclient, tektonclient, namespace, and service account in case it needs to find that task in cluster or authorize against an external repositroy. It will figure out whether it needs to look in the cluster or in a remote image to fetch the reference. It will also return the "kind" of the task being referenced. OCI bundle and remote resolution tasks will be verified by trusted resources if the feature is enabled

func GetTaskFuncFromTaskRun 

func GetTaskFuncFromTaskRun(ctx context.Context, k8s kubernetes.Interface, tekton clientset.Interface, requester remoteresource.Requester, taskrun *v1.TaskRun, verificationPolicies []*v1alpha1.VerificationPolicy) GetTask

GetTaskFuncFromTaskRun is a factory function that will use the given TaskRef as context to return a valid GetTask function. It also requires a kubeclient, tektonclient, namespace, and service account in case it needs to find that task in cluster or authorize against an external repositroy. It will figure out whether it needs to look in the cluster or in a remote image to fetch the reference. It will also return the "kind" of the task being referenced. OCI bundle and remote resolution tasks will be verified by trusted resources if the feature is enabled

type GetTaskRun 

type GetTaskRun func(string) (*v1.TaskRun, error)

GetTaskRun is a function used to retrieve TaskRuns

type LocalStepActionRefResolver 

type LocalStepActionRefResolver struct {
	Namespace    string
	Tektonclient clientset.Interface
}

LocalStepActionRefResolver uses the current cluster to resolve a StepAction reference.

func (*LocalStepActionRefResolver) GetStepAction 

func (l *LocalStepActionRefResolver) GetStepAction(ctx context.Context, name string) (*v1alpha1.StepAction, *v1.RefSource, error)

GetStepAction will resolve a StepAction from the local cluster using a versioned Tekton client. It will return an error if it can't find an appropriate StepAction for any reason.

type LocalTaskRefResolver 

type LocalTaskRefResolver struct {
	Namespace    string
	Kind         v1.TaskKind
	Tektonclient clientset.Interface
}

LocalTaskRefResolver uses the current cluster to resolve a task reference.

func (*LocalTaskRefResolver) GetTask 

func (l *LocalTaskRefResolver) GetTask(ctx context.Context, name string) (*v1.Task, *v1.RefSource, *trustedresources.VerificationResult, error)

GetTask will resolve either a Task or ClusterTask from the local cluster using a versioned Tekton client. It will return an error if it can't find an appropriate Task for any reason. TODO(#6666): support local task verification

type ResolvedTask 

type ResolvedTask struct {
	TaskName string
	Kind     v1.TaskKind
	TaskSpec *v1.TaskSpec
	// VerificationResult is the result from trusted resources if the feature is enabled.
	VerificationResult *trustedresources.VerificationResult
}

ResolvedTask contains the data that is needed to execute the TaskRun.

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.