logo
Alauda DevOps Pipelines Docs
English
简体中文
English
简体中文
logo
Alauda DevOps Pipelines Docs
导航

概览

介绍
架构
快速开始
生命周期策略
发版日志
特性概述

触发器

介绍
架构

核心概念

Tekton Triggers 核心概念
EventListener
触发器
Interceptor
TriggerBinding
TriggerTemplate
快速开始

实用指南

设置事件监听器
使用 GitLab 事件触发器
创建 TriggerTemplate

问题处理

Pipeline 未被自动触发
permissions

概念

TektonConfig
TektonPipeline
安装

升级

升级路径
升级 Alauda DevOps Pipelines Operator

配置

调整子组件的可选配置项
配置流水线组件的资源配额
Pod 模板配置指南
定期清理 TaskRun 和 PipelineRun 资源

How To

通过 TektonConfig 在 global 集群中部署 tekton-pipelines

管道

介绍
架构

概念

任务
TaskRuns
流水线
PipelineRuns
StepActions
解析器
工作空间
Pod 模板
快速开始

实用指南

调整 Dockerfile 构建适用于 Task 的自定义镜像
Specifying remote pipelines using hub resolvers
Specifying remote tasks using hub resolvers
使用 java-image-build-scan-deploy 管道

故障排查

在 Tekton 中使用自定义镜像时遇到容器创建失败的问题
在 run-script Task 中使用自定义镜像时遇到权限不够的问题
在 Tekton 中遇到无法使用多个基于 PVC 的工作区的问题
权限

结果

介绍
架构

核心概念

核心概念
深入理解 Tekton Results
快速开始
permissions

配置

数据库配置

供应链安全

介绍
架构

概念

核心概念
了解 Tekton Chains

快速开始

Getting Started
签名证明

实用指南

生成镜像签名并验证镜像完整性
构建系统溯源验证
源代码仓库验证
漏洞扫描和验证
Base Image and SBOM Verification
License Compliance Verification
Keyless Signing Verification

配置

链配置
链配置
Authentication for Chains
签名密钥配置

Hub

引言
架构

核心概念

概念
理解 Tekton Hub
权限描述

API Reference

介绍

Kubernetes APIs

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]

管道

Pipeline [tekton.dev/v1]
任务 [tekton.dev/v1]
PipelineRun [tekton.dev/v1]
TaskRun [tekton.dev/v1]
集群任务 [tekton.dev/v1]
运行 [tekton.dev/v1]
CustomRun [tekton.dev/v1]
StepAction [tekton.dev/v1]
VerificationPolicy [tekton.dev/v1alpha1]
ResolutionRequest [resolution.tekton.dev/v1beta1]

Triggers

触发器 [triggers.tekton.dev/v1beta1]
TriggerTemplate [triggers.tekton.dev/v1beta1]
EventListener [triggers.tekton.dev/v1beta1]
触发绑定 [triggers.tekton.dev/v1beta1]
拦截器 [triggers.tekton.dev/v1alpha1]
集群触发器绑定 [triggers.tekton.dev/v1beta1]
集群拦截器 [triggers.tekton.dev/v1alpha1]

高级 API

Results

Introduction to API Usage
Results 列表
结果详情
结果记录列表
Result logs 列表
📝 在 GitHub 上编辑此页
上一页EventListener
下一页Interceptor

#触发器

触发器是 Tekton Triggers 中的一个关键组件,指定当事件监听器检测到事件时会发生什么。它通过定义如何处理、提取和使用传入数据,以将事件数据连接到管道执行,从而创建 Kubernetes 资源。

#目录

#术语解释

术语描述
触发器一种 Tekton 资源,定义检测到事件时发生的操作,将事件数据与管道执行联系起来。
触发器绑定一种从事件负载中提取字段并将其绑定到命名参数的资源。
触发器模板一种在收到事件时指定需要创建的资源(如 TaskRuns 或 PipelineRuns)的资源。
事件监听器一种 Kubernetes 服务,监听事件并根据定义的触发器处理它们。
拦截器一种可选组件,在传递到触发器绑定和触发器模板之前处理和过滤事件数据。

#为什么需要触发器

#事件驱动的 CI/CD 挑战

在传统的 CI/CD 系统中,将外部事件(如 Git 推送或 webhook 调用)连接到管道执行需要:

  • 针对每个事件源编写自定义集成代码
  • 手动配置以将事件数据映射到管道参数
  • 复杂的逻辑来确定何时以及如何运行特定的管道
  • 对不同环境和条件的单独处理

这种方法导致:

  • 事件源与管道执行之间的紧密耦合
  • 项目间集成代码的重复
  • 维护和演化系统的困难
  • 集成模式的有限重用性

#触发器如何解决这些问题

Tekton Trigger 提供了一种声明性、Kubernetes 原生的方式来:

  1. 定义事件处理逻辑:精确指定事件应如何处理,无需自定义代码
  2. 提取相关数据:使用触发器绑定从事件负载中提取特定字段
  3. 创建适当的资源:使用触发器模板根据事件数据动态创建合适的资源
  4. 过滤和转换事件:应用拦截器,在处理之前验证、过滤和转换事件数据
  5. 关注点分离:将事件接收与资源创建解耦,以便更好的可维护性

这种方法实现了一个完全事件驱动的 CI/CD 系统,可以自动响应各种外部事件,同时保持灵活性和可重用性。

#优势

  • 声明性配置:使用 Kubernetes 资源定义事件到管道的连接
  • 重用性:创建可重用的触发器,可以在多个项目中应用
  • 灵活性:支持各种事件源(如 GitHub、GitLab、通用 webhooks 等)
  • 可扩展性:可以为专业事件处理创建自定义拦截器
  • 关注点分离:在事件接收、数据提取和资源创建之间有清晰的分离
  • 安全性:内置支持事件验证和过滤
  • Kubernetes 原生:与 Kubernetes 生态系统无缝集成

#适用场景

触发器在以下场景中是必不可少的:

  1. 自动化 CI/CD 管道:在代码推送到存储库时自动启动构建和部署。
  2. 多环境部署:使用相同的事件数据,但针对不同环境触发不同管道。
  3. ChatOps:根据拉取请求或问题中的评论执行管道。
  4. 定期操作:与 cron 任务结合触发周期性维护或测试管道。
  5. 跨服务工作流:在其他系统(如问题追踪器、监控系统)发生事件时触发管道。
  6. GitOps:在 Git 存储库更新时自动应用配置更改。

#约束和局限性

  • 触发器需要一个事件监听器来接收和处理事件
  • 每个事件监听器创建一个需要对事件源可访问的 Kubernetes 服务
  • 复杂的事件处理可能需要自定义拦截器
  • 事件源必须能够向事件监听器发送 HTTP 请求
  • 必须处理 webhook 的安全性考虑(身份验证、授权)

#原则

#触发器结构

Tekton 中的触发器资源具有以下结构:

apiVersion: triggers.tekton.dev/v1beta1
kind: Trigger
metadata:
  name: trigger-name
spec:
  # 可选:处理和过滤事件
  interceptors:
    - ref:
        name: "interceptor-name"
      params:
        - name: "param-name"
          value: "param-value"
  
  # 从事件中提取数据
  bindings:
    - ref: binding-name  # 引用现有的触发器绑定
    # 或直接嵌入绑定
    - name: param-name
      value: $(body.field.path)
  
  # 指定要创建的资源
  template:
    ref: template-name  # 引用现有的触发器模板
    # 或直接嵌入模板
    # spec: ...
  
  # 可选:用于资源创建的 ServiceAccount
  serviceAccountName: service-account-name

#关键组件及其关系

  1. 拦截器:在事件到达绑定和模板之前处理传入事件

    • 基于特定条件过滤事件
    • 转换事件数据
    • 向事件负载添加额外数据
    • 验证事件的真实性
  2. 绑定:从事件负载中提取数据

    • 可以引用现有的触发器绑定或集群触发器绑定
    • 可以直接嵌入到触发器中
    • 可以在一个触发器中结合多个绑定
  3. 模板:定义要创建的资源

    • 可以引用现有的触发器模板
    • 可以直接嵌入到触发器中
    • 使用绑定提取的参数
  4. 服务账户:为创建资源提供必要的权限

    • 必须具备创建模板中定义的资源的权限

#配置示例

#GitHub 拉取请求触发器

apiVersion: triggers.tekton.dev/v1beta1
kind: Trigger
metadata:
  name: github-pull-request-trigger
spec:
  interceptors:
    - ref:
        name: "github"
      params:
        - name: "eventTypes"
          value: ["pull_request"]
    - ref:
        name: "cel"
      params:
        - name: "filter"
          value: "body.action in ['opened', 'synchronize', 'reopened']"
        - name: "overlays"
          value:
            - key: truncated_sha
              expression: "body.pull_request.head.sha.truncate(7)"
  bindings:
    - name: git-revision
      value: $(body.pull_request.head.sha)
    - name: git-repository-url
      value: $(body.repository.clone_url)
    - name: pull-request-number
      value: $(body.number)
  template:
    ref: pull-request-template

#GitLab 推送事件触发器

基于提供的 GitLab 事件文档:

apiVersion: triggers.tekton.dev/v1beta1
kind: Trigger
metadata:
  name: gitlab-push-trigger
spec:
  interceptors:
    - ref:
        name: "gitlab"
      params:
        - name: "eventTypes"
          value: ["Push Hook"]
  bindings:
    - name: git-revision
      value: $(body.checkout_sha)
    - name: git-repository-url
      value: $(body.project.git_http_url)
    - name: git-repo-name
      value: $(body.project.name)
    - name: git-commit-message
      value: $(body.commits[0].message)
  template:
    ref: gitlab-ci-template

#与触发器相关的重要参数解释

#拦截器

拦截器是强大的组件,它们在事件到达触发器绑定和触发器模板之前处理事件。

#适用场景

  • 验证 webhook 签名
  • 基于特定条件过滤事件
  • 转换事件数据
  • 为事件添加额外上下文

#约束和局限性

  • 每个拦截器都会增加事件处理的时间
  • 复杂的过滤逻辑可能需要 CEL 表达式
  • 自定义拦截器需要额外的部署和管理

#原则/参数说明

常见的拦截器包括:

  • GitHub:验证 GitHub webhook 签名并按事件类型过滤
  • GitLab:验证 GitLab webhook 签名并按事件类型过滤
  • BitBucket:验证 BitBucket webhook 签名并按事件类型过滤
  • CEL:使用公共表达式语言进行过滤和转换
  • Webhook:使用密钥验证 webhook 签名

#绑定

触发器中的绑定字段指定如何从事件中提取数据。

#适用场景

  • 提取 Git 提交信息
  • 捕获关于拉取请求或合并请求的元数据
  • 检索存储库信息
  • 访问自定义头或负载字段

#配置示例

bindings:
  # 引用现有的触发器绑定
  - ref: common-git-binding

  # 直接嵌入绑定
  - name: custom-field
    value: $(body.custom.field)

  # 引用集群触发器绑定
  - ref: cluster-git-binding
    kind: ClusterTriggerBinding

#参考材料

  • Tekton Triggers 文档
  • 触发器官方文档
  • 事件监听器文档
  • 触发器绑定文档
  • 触发器模板文档
  • 拦截器文档