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 Results

#核心概念

本文件介绍了Tekton Results的基本概念,帮助您理解其目的、组件和数据模型。

#目录

#什么是Tekton Results?

Tekton Results是Tekton CI/CD生态系统的一个组成部分,提供对Tekton执行数据的长期存储和查询能力。它帮助用户将CI/CD工作负载历史进行逻辑分组,并将长期结果存储与Pipeline控制器分离。

Tekton Results的主要优点包括:

  • 持久存储:将执行历史(TaskRuns、PipelineRuns、日志)存储在专用数据库中,而不是Kubernetes的etcd
  • 结果分组:将相关工作负载分组在一起(例如,将相关的TaskRuns和PipelineRuns打包为一个单元)
  • 资源优化:通过将已完成的运行迁移到外部存储来释放etcd资源
  • 日志保留:存储TaskRuns/PipelineRuns产生的日志,以便可以清理已完成的运行以节省集群资源

#关键组件

Tekton Results由三个主要组件组成:

#1. API服务器

API服务器提供一个可查询的gRPC和REST接口,支持持久存储。它允许用户:

  • 存储和检索执行数据(TaskRuns、PipelineRuns、日志)
  • 根据各种标准查询和过滤结果
  • 将相关执行分组在一起

API服务器使用Kubernetes风格的身份验证和授权,使得Kubernetes生态系统的用户更容易上手。

#2. 观察者

观察者是一个Kubernetes控制器,负责:

  • 监视集群中的TaskRun和PipelineRun变化
  • 自动在Results数据库中创建或更新相应的记录
  • 为原始的TaskRun/PipelineRun对象添加结果标识符注解
  • 在将已完成的运行存储到数据库后,选择性地删除这些运行

观察者确保执行数据能够自动捕获,而不需要对现有的Tekton工作流进行更改。

#3. 保留策略代理

保留策略代理通过以下方式管理存储数据的生命周期:

  • 根据可配置策略从数据库中删除较旧的结果及其相关记录
  • 根据计划运行修剪作业
  • 强制执行执行数据的最大保留期限

#数据模型

Tekton Results使用一个分层数据模型,由两个主要实体组成:

#结果

结果是顶级聚合器,将相关记录分组在一起。它们表示一个逻辑工作单元,例如由特定事件触发的CI/CD管道执行。结果包含:

  • 唯一标识符
  • 元数据(创建时间,更新时间)
  • 注解(自定义元数据的键值对)
  • 摘要信息(状态,类型等)

#记录

记录是属于结果的单个数据实例。它们代表CI/CD工作流中的特定工件或事件,例如:

  • TaskRun执行
  • PipelineRun执行
  • 日志数据
  • 事件数据

记录包含:

  • 唯一名称
  • 指向其父结果的引用
  • 数据类型标识符(例如,tekton.dev/v1.TaskRun,tekton.dev/v1.PipelineRun)
  • 实际数据内容(存储为序列化对象)

这种数据模型允许灵活组织CI/CD执行数据,使其更容易跟踪和查询相关活动。

#结果的生命周期

Tekton Results中数据的典型流动过程如下:

  1. 用户通过Kubernetes API创建TaskRun或PipelineRun
  2. 结果观察者检测到新资源并监视其变化
  3. 当TaskRun/PipelineRun被更新时,观察者在Results数据库中创建或更新相应的记录
  4. 观察者为原始TaskRun/PipelineRun添加结果标识符注解
  5. 用户可以查询Results API以检索执行数据
  6. 一旦数据安全存储在Results数据库中,原始Kubernetes资源可以安全地从集群中移除

这一流程确保了即使原始Kubernetes资源被删除,执行数据仍然被保留,提供了CI/CD活动的完整历史记录。

#参考资料

  • Tekton Results文档
  • Tekton Results GitHub仓库
  • TEP-0021: 结果API