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 上编辑此页
上一页Pod 模板配置指南
下一页How To

#定期清理 TaskRun 和 PipelineRun 资源

#目录

#概述

通过 Pruner 功能自动清理 Tekton 中的 TaskRun 和 PipelineRun 资源。Pruner 在后台运行,执行 tkn 命令以进行资源清理。

#用例

  • 定期清理 TaskRun 资源
  • 定期清理 PipelineRun 资源
  • 基于命名空间配置不同的清理策略

#前提条件

  • 必须安装 Tekton Operator 组件
  • TektonConfig 资源必须在环境中自动创建

#步骤

#步骤 1

编辑 TektonConfig 资源

$ kubectl edit tektonconfigs.operator.tekton.dev config

#步骤 2

按如下所示修改 spec.pruner 配置:

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  pruner:
    # 是否禁用 Pruner 功能,默认为 false
    disabled: false
    # 定时清理的 Cron 表达式
    schedule: "0 8 * * *"
    # 可选:任务开始的截止日期(以秒为单位)
    startingDeadlineSeconds: 100
    # 要清理的资源类型
    resources:
      - taskrun
      - pipelinerun
    # 保留的资源数量
    keep: 3
    # 对每种资源类型分别应用清理策略
    prune-per-resource: true
    # 在指定时间内保留资源(以分钟为单位)
    # keep-since: 1440
    # 注意:只能使用 keep 和 keep-since 之一

关键配置描述:

  • disabled:设置为 true 时,禁用 Pruner 功能(默认值为 false)
  • schedule:清理任务的执行时间表,使用 cron 表达式格式
  • startingDeadlineSeconds:可选配置,任务开始的截止日期(以秒为单位)。如果任务错过预定时间并超过此持续时间,则视为失败
  • resources:支持的清理资源类型,包括 taskrun 和 pipelinerun
  • keep:在清理过程中保留的资源最大数量
  • keep-since:在指定时间内保留资源(以分钟为单位)
  • prune-per-resource:设置为 true 时(默认值为 false),对每种资源单独应用 keep 配置
    • 例如:如果命名空间 ns-1 中有两个 Pipelines,分别为 pipeline-1 和 pipeline-2,将执行以下命令:
      tkn pipelinerun delete --pipeline=my-pipeline-1 --keep=3 --namespace=ns-1
      tkn pipelinerun delete --pipeline=my-pipeline-2 --keep=3 --namespace=ns-1
    • 注意:使用 keep-since 时,启用 prune-per-resource=true 是没有实际意义的,因为 keep-since 是基于资源的时间约束,与资源的数量无关。
NOTE

如果 disabled: false 并且 schedule 为空,则全局 Pruner 任务将禁用。 但是,如果命名空间中存在带值的注解 operator.tekton.dev/prune.schedule,则将为该命名空间创建一个 Pruner 任务。

#步骤 3

通过命名空间注解配置清理策略(可选)

默认情况下,Pruner 任务将使用全局配置(spec.pruner),但用户可以通过以下注解自定义特定命名空间的 Pruner 配置。如果某些注解缺失或值无效,将使用全局配置值,或者跳过该命名空间。

支持的注解:

  • operator.tekton.dev/prune.skip:设置为 true 时,跳过该命名空间的 Pruner 任务
  • operator.tekton.dev/prune.schedule:设置该命名空间的清理时间表
  • operator.tekton.dev/prune.keep:设置最大保留的资源数量
  • operator.tekton.dev/prune.keep-since:设置在指定时间内保留资源的时间(以分钟为单位)
  • operator.tekton.dev/prune.prune-per-resource:设置是否对每种资源单独应用清理策略
  • operator.tekton.dev/prune.resources:设置要清理的资源类型,可以是 taskrun 和/或 pipelinerun,多个值用逗号分隔
  • operator.tekton.dev/prune.strategy:设置清理策略,可选值为 keep 或 keep-since

示例:

$ kubectl annotate namespace default \
    operator.tekton.dev/prune.schedule="0 1 * * *" \
    operator.tekton.dev/prune.keep="5" \
    operator.tekton.dev/prune.resources="taskrun,pipelinerun"
NOTE

如果未设置全局配置,将使用以下默认值:

  • resources: pipelinerun
  • keep: 100

#结果

配置完成后,系统将根据设置的时间表自动清理过期的 TaskRun 和 PipelineRun 资源。

#参考

  • 官方文档:Pruner 配置