logo
Alauda DevOps Pipelines Docs
logo
Alauda DevOps Pipelines Docs
Navigation

Overview

Introduction
Architecture
Feature Overview
Lifecycle Policy
Quick Start
Release Notes

Concepts

TektonConfig
TektonPipeline
Install
Upgrade

Configure

Adjusting Optional Configuration Items of Subcomponents
Configuring Resource Quotas for Pipeline Components
Pod Template Configuration Guide
Regular Cleanup of TaskRun and PipelineRun Resources

How To

Deploying tekton-pipelines in a global cluster through TektonConfig

Pipelines

Introduction
Architecture

Concepts

Tasks
TaskRuns
Pipelines
PipelineRuns
StepActions
Resolvers
Workspaces
Pod Templates
Quick Start
permissions

how_to

Adjust Dockerfile for Building Task-Compatible Custom Images

trouble_shooting

Failed to create pod due to config error when using custom images in Tekton

Triggers

Introduction
Architecture

Core Concepts

Core Concepts
EventListener
Trigger
Interceptor
TriggerBinding
TriggerTemplate
Quick Start

How To

Setup EventListener
Use GitLab Event Triggers
Create TriggerTemplate

Troubleshooting

The Pipeline is not automatically triggered
Permission Description

Hub

Introduction
Architecture

Core Concepts

Concepts
Understanding Tekton Hub
Permission Description

Configure

Tekton Hub Configuration
Adding Custom Catalogs

Tutorials

Creating a Custom Catalog
Writing Tasks for Tekton Hub
Writing Pipelines for Tekton Hub

Results

Introduction
Architecture

Concepts

Core Concepts
Tekton Results
Quick Start
permissions

Configure

Database Configuration

Supply Chain Security

Introduction
Architecture

Concepts

Core Concepts
Understanding Tekton Chains
Quick Start

API Reference

Introduction

Kubernetes APIs

Pipelines

Pipeline [tekton.dev/v1]
Task [tekton.dev/v1]
PipelineRun [tekton.dev/v1]
TaskRun [tekton.dev/v1]
ClusterTask [tekton.dev/v1]
Run [tekton.dev/v1]
CustomRun [tekton.dev/v1]
StepAction [tekton.dev/v1]
VerificationPolicy [tekton.dev/v1alpha1]
ResolutionRequest [resolution.tekton.dev/v1beta1]

Triggers

Trigger [triggers.tekton.dev/v1beta1]
TriggerTemplate [triggers.tekton.dev/v1beta1]
EventListener [triggers.tekton.dev/v1beta1]
TriggerBinding [triggers.tekton.dev/v1beta1]
Interceptor [triggers.tekton.dev/v1alpha1]
ClusterTriggerBinding [triggers.tekton.dev/v1beta1]
ClusterInterceptor [triggers.tekton.dev/v1alpha1]

Operator

TektonConfig [operator.tekton.dev/v1alpha1]
TektonInstallerSet [operator.tekton.dev/v1alpha1]
TektonPipeline [operator.tekton.dev/v1alpha1]
TektonTrigger [operator.tekton.dev/v1alpha1]
TektonChain [operator.tekton.dev/v1alpha1]
TektonHub [operator.tekton.dev/v1alpha1]
TektonResult [operator.tekton.dev/v1alpha1]
TektonInstallerSet [operator.tekton.dev/v1alpha1]
OpenShift Pipelines as Code [operator.tekton.dev/v1alpha1]

Advanced APIs

Results

Introduction to API Usage
Results List
Results Details
Result records List
Result logs List
📝 Edit this page on GitHub
Previous PageCore Concepts
Next PageEventListener

#Core Concepts

Tekton Triggers is a powerful extension to Tekton Pipelines that enables event-driven workflows. It allows you to automatically trigger pipeline executions in response to events from various sources like Git repositories, container registries, or custom webhooks. This document provides an overview of the core concepts in Tekton Triggers and links to in-depth explanations of each concept.

#TOC

#Overview of Tekton Triggers Components

Tekton Triggers consists of several key components that work together to enable event-driven automation:

Tekton Triggers Flow

#Trigger

A Trigger specifies what happens when an EventListener detects an event. It connects TriggerBindings (for data extraction) with TriggerTemplates (for resource creation) and optionally includes Interceptors for event filtering and processing.

In-Depth Understanding of Trigger

#TriggerBinding

A TriggerBinding extracts fields from event payloads (like webhooks) and binds them to named parameters that can be used in TriggerTemplates. This allows you to use specific data from events in your pipeline executions.

In-Depth Understanding of TriggerBinding

#TriggerTemplate

A TriggerTemplate defines the blueprint for resources (like PipelineRuns or TaskRuns) that should be created when an event is received. It uses parameters from TriggerBindings to dynamically create resources with event-specific data.

In-Depth Understanding of TriggerTemplate

#EventListener

An EventListener is a Kubernetes service that listens for events (webhooks) and processes them according to defined Triggers. It receives events, applies Interceptors, extracts data via TriggerBindings, and creates resources via TriggerTemplates.

In-Depth Understanding of EventListener

#Interceptor

An Interceptor processes and filters events before they reach TriggerBindings and TriggerTemplates. Interceptors can validate webhook signatures, filter events based on content, and transform event data to make it more suitable for pipeline consumption.

In-Depth Understanding of Interceptor

#How These Components Work Together

  1. An EventListener receives an event (webhook) from an external system
  2. Interceptors validate, filter, and process the event
  3. TriggerBindings extract relevant data from the event
  4. TriggerTemplates use the extracted data to create resources
  5. The created resources (typically PipelineRuns) execute the CI/CD workflow

This event-driven approach enables fully automated CI/CD pipelines that respond to events from your development ecosystem without manual intervention.