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 是一个基于 Kubernetes 的事件监听和处理系统,它通过将外部事件(如 Git 提交、镜像推送等)转换为 Kubernetes 资源来实现 CI/CD 流水线的自动触发。

Tekton Triggers 架构图

#核心组件

#1. EventListener(事件监听器)

EventListener 是整个系统的入口点,它:

  • 创建一个 Kubernetes Service 和 Pod
  • 暴露 HTTP 端点以接收外部事件
  • 管理事件的处理流程
  • 支持多种认证方式

主要职责:

  • 接收和验证 Webhook 事件
  • 根据配置调用相应的拦截器
  • 执行触发器逻辑
  • 创建 Kubernetes 资源

#2. Trigger(触发器)

Trigger 定义了如何处理接收到的事件,它包含:

  • TriggerBinding:数据提取规则
  • TriggerTemplate:资源模板
  • Interceptors:事件拦截器(可选)

工作流程:

  1. 接收事件数据
  2. 通过拦截器处理(如果配置)
  3. 使用 TriggerBinding 提取数据
  4. 将数据应用到 TriggerTemplate

#3. Interceptor(拦截器)

拦截器在事件处理流程中提供额外的处理层:

  • 事件过滤
  • 负载验证
  • 数据转换
  • 认证与授权

支持两种类型:

  1. 内置拦截器

    • GitHub
    • GitLab
    • Bitbucket
    • CEL(通用表达式语言)
  2. 自定义拦截器

    • 独立部署的服务
    • 实现标准接口
    • 高度可扩展

#4. TriggerBinding(触发器绑定)

负责从事件数据中提取信息:

  • 定义数据映射规则
  • 支持 JSONPath 语法
  • 可以是集群级或命名空间级

主要功能:

  • 参数提取
  • 数据转换
  • 变量映射

#5. TriggerTemplate(触发器模板)

定义要创建的 Kubernetes 资源:

  • 支持参数化模板
  • 可以创建多个资源
  • 支持动态命名

特点:

  • 资源模板化
  • 参数替换
  • 动态生成名称

#工作流程

  1. 事件接收

    • 外部系统发送 Webhook 到 EventListener
    • EventListener 验证请求
  2. 拦截器处理

    • 调用配置的拦截器链
    • 执行验证和转换
    • 可以终止或修改请求
  3. 数据提取

    • TriggerBinding 从事件中提取数据
    • 应用数据映射规则
    • 准备参数
  4. 资源创建

    • TriggerTemplate 使用提取的数据
    • 替换模板中的参数
    • 创建 Kubernetes 资源

#部署架构

#基础组件

  1. EventListener Pod

    • 运行事件接收服务
    • 包含核心处理逻辑
    • 需要特定的 RBAC 权限
  2. EventListener Service

    • 暴露 HTTP 端点
    • 支持不同的服务类型
    • 可配置 TLS

#可选组件

  1. Interceptor 服务

    • 独立部署的拦截器
    • 自定义事件处理逻辑
    • 需要网络可达性
  2. Ingress/Route

    • 外部访问配置
    • TLS 终止
    • 路由规则

#安全架构

#认证机制

  1. Webhook 认证

    • Secret Token 验证
    • 签名验证
    • OAuth 集成
  2. Kubernetes 认证

    • ServiceAccount
    • RBAC 权限
    • Secret 管理

#授权控制

  1. 资源访问控制

    • 基于角色的访问控制
    • 命名空间隔离
    • 最小权限原则
  2. 网络安全

    • TLS 加密
    • 网络策略
    • 访问限制

#扩展性设计

#1. 自定义拦截器

  • 标准 HTTP 接口
  • 灵活的部署选项
  • 可插拔架构

#2. 资源模板

  • 支持多种资源类型
  • 参数化配置
  • 动态生成