#Регулярная очистка ресурсов TaskRun и PipelineRun

#Шаг 1

Отредактируйте ресурс TektonConfig

$ kubectl edit tektonconfigs.operator.tekton.dev config

#Шаг 2

Измените конфигурацию spec.pruner, как показано ниже:

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  pruner:
    # Whether to disable the pruner functionality, defaults to false
    disabled: false
    # Cron expression for scheduled cleanup
    schedule: "0 8 * * *"
    # Optional: Deadline for task start (in seconds)
    startingDeadlineSeconds: 100
    # Types of resources to clean up
    resources:
      - taskrun
      - pipelinerun
    # Number of resources to retain
    keep: 3
    # Apply cleanup strategies separately for each resource type
    prune-per-resource: true
    # Retain resources within the specified time (in minutes)
    # keep-since: 1440
    # Note: only one of keep and keep-since can be used

Описание ключевых параметров конфигурации:

• disabled: Если задано значение true, отключает функцию pruner (значение по умолчанию: false)
• schedule: Расписание выполнения задачи очистки в формате cron expression
• startingDeadlineSeconds: Необязательный параметр срока начала задачи (в секундах). Если задача пропустит запланированное время и превысит этот интервал, она будет считаться неуспешной
• resources: Поддерживаемые типы ресурсов для очистки, включая taskrun и pipelinerun
• keep: Максимальное количество ресурсов, которое следует сохранить во время очистки
• keep-since: Сохранять ресурсы в течение заданного времени (в минутах)
• prune-per-resource: Если задано значение true (значение по умолчанию: false), параметр keep применяется отдельно к каждому ресурсу
  • Например: если в namespace ns-1 есть два Pipeline с именами 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 основан на ограничении по времени для ресурсов и не связан с их количеством.

#Шаг 3

Настройте стратегии очистки с помощью аннотаций namespace (необязательно)

По умолчанию задача pruner будет использовать глобальную конфигурацию (spec.pruner), но пользователи могут настраивать конфигурацию pruner для определённых namespace с помощью следующих аннотаций. Если некоторые аннотации отсутствуют или имеют недопустимые значения, будут использованы значения глобальной конфигурации, либо namespace будет пропущен.

Поддерживаемые аннотации:

• operator.tekton.dev/prune.skip: Если задано значение true, пропускает задачу pruner для этого namespace
• operator.tekton.dev/prune.schedule: Задает расписание очистки для этого namespace
• 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 :::