ghcr.io/tektoncd/results/api-b1b7ffa9ba32f7c3020c3b68830b30a8:v0.17.2

Tekton Results

Tekton Results 旨在帮助用户对 CI/CD 工作负载历史进行逻辑分组，并将长期结果存储与 Pipeline 控制器分离。这使您能够：

• 提供 Tekton TaskRun/PipelineRun CRD 中未包含的 CI/CD 工作流自定义 Result 元数据（例如：运行后操作）
• 将相关工作负载分组（例如：将相关 TaskRun 和 PipelineRun 捆绑为单个单元）
• 使长期结果历史独立于 Pipeline CRD 控制器，从而释放 etcd 资源用于 Run 执行
• 存储 TaskRun/PipelineRun 生成的日志，以便清理已完成的 Run 以节省资源

更多背景信息和设计动机可参见 TEP-0021。

概述

Tekton Results 由 3 个主要组件构成：

• 一个由持久化存储支持的可查询 gRPC API 服务器（最新 API 规范见 proto/v1alpha2）
• 一个用于监视并向 API 服务器报告 TaskRun 和 PipelineRun 更新的控制器
• 一个保留策略代理，用于从数据库中删除较旧数据的代理

Result 的生命周期

sequenceDiagram
actor U as Users
participant PC as Pipeline Controller
participant RW as Result Watcher
participant RA as Result API
U->>PC: Create PipelineRun/TaskRun
RW-->>PC: Watch PipelineRun/TaskRun
Note over PC,RW: 等待 PipelineRun/TaskRun 完成
RW->>RA: Update results database
U--)RA: Get Results

• 用户照常通过 Kubernetes API 创建 TaskRun 或 PipelineRun
• Result Watcher 监听所有 TaskRun/PipelineRun 变更
• 若 TaskRun/PipelineRun 发生变更，Watcher 会使用 Results API 更新（或创建）相应的 Record（必要时还有 Result）。Watcher 还会为原始 TaskRun/PipelineRun 添加标识符注解
• 用户可直接从 API 获取/查询 Result/Record 数据。一旦 TaskRun/PipelineRun 完成并成功存储到 Result API，原始 CRD 对象即可安全地从集群中移除

快速开始

• 安装
• Results API：了解如何连接到 API 并进行查询
• Watcher：了解 Watcher 支持的类型及其确定 Result 分组的方式

数据模型

graph BT
B(TaskRun) --> |Record| A[Result]
C(Log) --> |Record| A
D(PipelineRun) --> |Record| A

• Records 是数据的独立实例。通常为执行数据（如 PipelineRun、TaskRuns、Logs），但也可引用有关事件/执行的其他数据。Records 旨在灵活支持工具希望围绕 CI 事件提供的任意信息
• Results 是 Records 的聚合器，允许用户将一组 Records 作为单个实体引用。例如，单个 Result 可分组以下 Records：
  • 触发操作的源事件（如拉取请求、推送）
  • 发生的 PipelineRun
  • 响应 PipelineRun 发生的 TaskRun（每个 Task 一个）
  • Cloud Event 交付回执
  • 源状态更新回执

（注：Watcher 尚未支持所有这些数据类型，但它们是我们计划支持的数据示例）

有用链接

• 路线图
• Results API 查询指南

联系方式

• Tekton 社区
• #results - Tekton Slack