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 上编辑此页
上一页Tekton Triggers 核心概念
下一页触发器

#EventListener

EventListener 是 Tekton Triggers 中的一个基本组件,它充当外部事件的入口点。它提供了一种 Kubernetes 原生方式来接收、验证、过滤和处理来自外部系统的事件,最终触发 Tekton 资源的执行,如 PipelineRuns 和 TaskRuns。

#目录

#术语解释

术语描述
EventListener一个 Kubernetes 对象,监听 Kubernetes 集群上指定端口的事件
Trigger指定当 EventListener 检测到事件时发生什么,包括 TriggerTemplate、TriggerBinding 和可选的 Interceptors
Interceptor处理和过滤事件的组件,在它们到达 TriggerBinding 之前
TriggerBinding从事件负载中提取字段并将其绑定到参数
TriggerTemplate指定接收事件时要创建的资源(如 PipelineRun)的蓝图

#为什么需要 EventListener

#传统 CI/CD 挑战

在传统的 CI/CD 系统中,集成外部事件源通常需要:

  • 为每个事件源定制的 webhook 处理程序
  • 手动配置事件处理逻辑
  • 复杂的 webhook 接收器的部署和管理
  • 缺乏标准化的安全和验证机制

这些挑战导致 CI/CD 流水线的碎片化、安全漏洞和维护开销增加。

#EventListener 解决方案

EventListener 通过提供以下方式来解决这些挑战:

  1. 所有外部事件的统一入口点
  2. 通过 Kubernetes 资源进行声明性配置
  3. 内置的安全和验证机制
  4. 与 Tekton 的流水线执行系统无缝集成
  5. Kubernetes 原生的部署和扩展

#优势

  • Kubernetes 原生:作为标准 Kubernetes 资源(Deployment 和 Service)进行部署
  • 声明性配置:使用 YAML 定义,遵循 Kubernetes 模式
  • 可扩展:支持各种事件源和自定义拦截器
  • 安全:内置身份验证和验证机制
  • 可扩展性:可以水平扩展以处理大量事件
  • 灵活部署:支持各种网络配置(ClusterIP、NodePort、LoadBalancer、Ingress)

#适用场景

EventListener 非常适合于:

  1. CI/CD 自动化:当代码被推送或创建 PR 时自动触发流水线
  2. GitOps 工作流:响应 Git 仓库中的变化
  3. 多系统集成:将各种系统(GitHub、GitLab、Jenkins 等)连接到 Tekton 流水线
  4. 自定义事件处理:处理来自内部系统的自定义事件
  5. Webhook 管理:集中管理多个服务的 webhook 处理

#约束和限制

  • Kubernetes 依赖性:需要一个 Kubernetes 集群才能运行
  • 资源要求:根据事件量需要适当的 CPU 和内存资源
  • 网络配置:需要适当的网络设置以便外部访问
  • 安全考虑:需要适当的 RBAC 配置,并可能需要 TLS 设置
  • 扩展限制:非常高的事件量可能需要仔细的资源规划

#原则

EventListener 基于以下原则运作:

  1. 事件接收:EventListener 暴露一个 HTTP 端点,以接收来自外部系统的 webhook 事件。

  2. 事件处理流程:

    • 事件由 EventListener 服务接收
    • 事件由配置的拦截器进行验证和处理
    • 使用 TriggerBindings 提取事件数据
    • 根据 TriggerTemplates 创建资源
    • 创建的资源(例如 PipelineRuns)由 Tekton 执行
  3. 部署架构:

    • EventListener 作为 Kubernetes Deployment 进行部署
    • 创建一个 Service 来暴露 EventListener
    • EventListener 使用具有适当权限的 ServiceAccount
    • 可选的 Ingress/Route 用于外部访问
  4. 安全模型:

    • 通过拦截器进行身份验证
    • 通过 Kubernetes RBAC 进行授权
    • 验证事件负载
    • 可选的 TLS 加密

#配置示例

#基本 EventListener

apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: github-listener
spec:
  serviceAccountName: tekton-triggers-sa
  triggers:
    - name: github-push
      interceptors:
        - ref:
            name: "github"
          params:
            - name: "secretRef"
              value:
                secretName: github-secret
                secretKey: secretToken
            - name: "eventTypes"
              value: ["push"]
      bindings:
        - ref: github-push-binding
      template:
        ref: build-template

#具有多个触发器的 EventListener

apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: multi-listener
spec:
  serviceAccountName: tekton-triggers-sa
  triggers:
    - name: github-push
      interceptors:
        - ref:
            name: "github"
          params:
            - name: "eventTypes"
              value: ["push"]
      bindings:
        - ref: github-push-binding
      template:
        ref: build-template
    - name: github-pr
      interceptors:
        - ref:
            name: "github"
          params:
            - name: "eventTypes"
              value: ["pull_request"]
      bindings:
        - ref: github-pr-binding
      template:
        ref: pr-template

#重要参数解释

#ServiceAccountName

ServiceAccount 参数对于 EventListener 至关重要,因为它确定了 EventListener 创建资源所需的权限。

#适用场景

  • 当 EventListener 需要在多个命名空间中创建资源时
  • 当需要特定的安全约束时

#约束和限制

  • ServiceAccount 必须具有适当的 RBAC 权限
  • 应遵循最小权限原则

#原则

ServiceAccount 需要具有以下权限:

  • 读取 ConfigMaps、Secrets 和 ServiceAccounts
  • 创建和管理 PipelineRuns 和 TaskRuns
  • 访问 TriggerBindings 和 TriggerTemplates

#资源配置

resources 参数允许您自定义 EventListener 的部署方式。

#适用场景

  • 高可用性部署
  • 自定义资源需求
  • 特定网络要求

#原则

可以配置:

  • 高可用性的副本数
  • 资源限制和请求
  • 服务类型(ClusterIP、NodePort、LoadBalancer)
  • 自定义 Pod 模板规格

#参考资料

  • Tekton Triggers 官方文档
  • EventListener API 参考
  • Tekton 触发器示例