Alauda DevOps Pipelines Docs
  • 简体中文

    • 基于时间的清理 (TTL)

    使用 ttlSecondsAfterFinished 在指定时长后删除已完成的资源。

    目录

    工作原理基本配置常见 TTL 值按环境划分的 TTL按 Pipeline 划分的 TTL将 TTL 与历史限制结合使用最佳实践相关内容

    工作原理

    TTL 适用于所有已完成的运行（成功和失败）。计时器在运行完成时开始。

    基本配置

    apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  pruner:
    disabled: true  # Must disable job-based pruner
  tektonpruner:
    disabled: false  # Enable event-based pruner
    global-config:
      ttlSecondsAfterFinished: 3600  # Delete after 1 hour

    常见 TTL 值

    持续时间秒数使用场景
    5 分钟300Dev/test 快速迭代
    1 小时3600CI pipelines
    1 天86400通用工作负载
    7 天604800staging/release
    30 天2592000Production/audit/compliance

    按环境划分的 TTL

    spec:
  tektonpruner:
    global-config:
      enforcedConfigLevel: namespace
      ttlSecondsAfterFinished: 3600  # Default
      namespaces:
        dev:
          ttlSecondsAfterFinished: 300      # 5 min
        staging:
          ttlSecondsAfterFinished: 86400    # 1 day
        prod:
          ttlSecondsAfterFinished: 2592000

    按 Pipeline 划分的 TTL

    在 Namespace ConfigMaps 中使用选择器来为特定 Pipeline 配置 TTL：

    WARNING

    Namespace 级别的 ConfigMaps 不在 TektonConfig 生命周期内。如果你需要在之后备份或恢复 Tekton 配置，请单独保存这些 ConfigMaps。

    apiVersion: v1
kind: ConfigMap
metadata:
  name: tekton-pruner-namespace-spec
  namespace: my-app
  labels:
    app.kubernetes.io/part-of: tekton-pruner
    pruner.tekton.dev/config-type: namespace
data:
  ns-config: |
    ttlSecondsAfterFinished: 3600
    pipelineRuns:
      - selector:
          matchLabels:
            pipeline-type: release
        ttlSecondsAfterFinished: 604800
      - selector:
          matchLabels:
            pipeline-type: test
        ttlSecondsAfterFinished: 300

    将 TTL 与历史限制结合使用

    历史限制会覆盖 TTL，以保证最少保留时间：

    data:
  ns-config: |
    ttlSecondsAfterFinished: 300
    successfulHistoryLimit: 5
    failedHistoryLimit: 10

    结果：资源会在 5 分钟后删除，除非它们属于最近 5 个成功运行或最近 10 个失败运行。

    最佳实践

    1. 开发：使用较短的 TTL（5-60 分钟）以支持快速迭代
    2. 生产：使用较长的 TTL（7-30 天）以满足审计/合规要求
    3. 关键 Pipeline：使用选择器实现更长的保留时间
    4. 平衡：在存储成本与保留需求之间进行权衡

    相关内容