tekton-pipelines

Author Tekton PipelineRun and TaskRun YAML with resolvers, matrix scheduling, and CEL conditions.

4|2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/Aidas-dev/k8s-agent-skills --skill tekton-pipelines-aidas-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tekton-pipelines
Source: https://github.com/Aidas-dev/k8s-agent-skills/tree/main/skills/tekton-pipelines
Command: npx skills add https://github.com/Aidas-dev/k8s-agent-skills --skill tekton-pipelines-aidas-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing correct Tekton CI/CD pipelines requires mastering many tekton.dev/v1 patterns—resolvers, git authentication, node targeting, matrix fan-out, CEL conditions, and timeout hierarchies—and small mistakes cause failed or misscheduled runs. ## Core Features & Use Cases - Resolver-Based Task Refs: Reference tasks via git, cluster, or hub resolvers instead of inline TaskSpecs, with configurable resolver cache TTL. - Git Authentication: Configure ServiceAccount secrets with tekton.dev/git annotations so creds-init authenticates all git operations against private repositories. - Scheduling & Conditions: Target nodes via podTemplate and taskRunSpecs, fan out builds with matrix params, gate tasks with when/CEL expressions, and run finally cleanup tasks. - Use Case: You need a multi-arch build pipeline that clones from a private GitHub repo, runs amd64 and arm64 builds on matching nodes, and sends a notification whether the build succeeds or fails. ## Quick Start Write a Tekton PipelineRun that clones my private repo, builds for amd64 and arm64 using a matrix, and runs a notification task in finally.

Frequently Asked Questions about tekton-pipelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reference a Tekton task from a git repository?▼

Use a taskRef with the git resolver, specifying url, revision, and pathInRepo params instead of embedding an inline TaskSpec. Resolvers keep pipelines DRY and support cluster and hub resolvers as alternatives.

How to authenticate Tekton with a private git repository?▼

Create a kubernetes.io/basic-auth secret annotated with tekton.dev/git-0 pointing at the host, then attach it to the pipeline's ServiceAccount secrets. Tekton's creds-init container configures git automatically for all clone, tag, and push operations.

How do I run Tekton tasks on specific nodes?▼

Set nodeSelector and tolerations in taskRunTemplate.podTemplate for pipeline-wide placement, or use taskRunSpecs with taskPodTemplate to override placement for a single named pipeline task.

Does Tekton support matrix builds for multiple architectures?▼

Yes, Tekton v1 supports matrix params that fan out a task across array-typed parameter values. Combine matrix with param substitution in podTemplate nodeSelector to schedule each build on matching architecture nodes.

When should I use CEL expressions instead of standard when conditions in Tekton?▼

Use the cel field (v1.13+) when you need complex logic like checking webhook payload fields or combining multiple conditions with boolean operators. Standard when with input/operator/values suffices for simple param comparisons.

What are common mistakes when writing Tekton v1 pipelines?▼

Common mistakes include using v1beta1 instead of tekton.dev/v1, inlining TaskSpecs instead of resolvers, putting CEL logic in input/values fields, using scalar params in matrix, and forgetting explicit timeouts on finally tasks.