How tektoncd/pipeline works
Tekton Pipelines is a Kubernetes-native system for declaring and running container-based CI/CD pipelines. Users define Pipeline and Task resources, submit a PipelineRun, and the controller resolves its tasks and reconciles TaskRuns; Kubernetes runs the resulting containers. The repository also provides admission and API-version conversion, remote resource resolvers, event notifications, and workload identity support. Edges reflect the README and source-index references shown here; some feature relationships are documented or strongly implied but not confirmed by sampled call sites, and are marked dashed.
Main entry points: pipelinerun.go PipelineRun reconciler · controller.go TaskRun reconciler · main.go Resolver startup · pipeline_validation.go Pipeline resources
Components 19
Pipeline APIs
- Pipeline resources
pkg/apis/pipeline/v1/pipeline_validation.go - PipelineRun resources
pkg/apis/pipeline/v1/pipelinerun_validation.go - v1beta1 API
pkg/apis/pipeline/v1beta1/pipeline_validation.go - API conversion
pkg/apis/pipeline/v1beta1/pipelinerun_conversion.go - Admission webhook
cmd/webhook/main.go
Run Control
- Controller startup
cmd/controller/main.go - PipelineRun reconciler
pkg/reconciler/pipelinerun/pipelinerun.go - Run state
pkg/reconciler/pipelinerun/resources/pipelinerunstate.go - Task resolution
pkg/reconciler/pipelinerun/resources/pipelinerunresolution.go - TaskRun reconciler
pkg/reconciler/taskrun/controller.go
Resource Resolution
- Resolver startup
cmd/resolvers/main.go - Remote resolver framework
pkg/remoteresolution/resolver/framework/controller.go - Resolution framework
pkg/resolution/resolver/framework/controller.go - Git resolver
pkg/resolution/resolver/git/repository.go
Task Runtime
- Step entrypoint
cmd/entrypoint/main.go
Platform Integrations
- Cloud events
pkg/reconciler/events/cloudevent/cloud_event_controller.go - SPIRE identity
pkg/spire/controller.go
Other components
- Pipeline author
- Kubernetes
Connections 20
- Pipeline author → Pipeline resources: declares
README.md - Pipeline author → PipelineRun resources: submits
- Pipeline resources → PipelineRun resources: defines inputs
- Admission webhook → Pipeline resources: admits resources
cmd/webhook/main.go - Admission webhook → v1beta1 API: converts versions
cmd/webhook/main.go - API conversion → PipelineRun resources: converts to
pkg/apis/pipeline/v1beta1/pipelinerun_conversion.go - Controller startup → PipelineRun reconciler: starts
cmd/controller/main.go - PipelineRun reconciler → Task resolution: resolves tasks
pkg/reconciler/pipelinerun/pipelinerun.go - PipelineRun reconciler → Run state: reads run state
pkg/reconciler/pipelinerun/pipelinerun.go - PipelineRun reconciler → TaskRun reconciler: creates TaskRuns
- PipelineRun reconciler → Kubernetes: reconciles resources
pkg/reconciler/pipelinerun/pipelinerun.go - TaskRun reconciler → Kubernetes: reconciles TaskRuns
pkg/reconciler/taskrun/controller.go - Kubernetes → Step entrypoint: runs containers
README.md - Resolver startup → Remote resolver framework: registers resolvers
cmd/resolvers/main.go - Resolver startup → Git resolver: configures Git
cmd/resolvers/main.go - Remote resolver framework → Kubernetes: watches requests
pkg/remoteresolution/resolver/framework/controller.go - Resolution framework → Kubernetes: watches requests
pkg/resolution/resolver/framework/controller.go - Task resolution → Resolver startup: requests resolution
- Cloud events → Kubernetes: publishes events
- TaskRun reconciler → SPIRE identity: uses identity