Alauda DevOps Pipelines Docs
  • Русский

    • Введение

    Tekton Results разработан для того, чтобы помочь пользователям логически группировать исторические записи CI/CD нагрузок и отделить долгосрочное хранение Results от контроллера Pipeline. Это позволяет:

    • Предоставлять пользовательские метаданные Results о CI/CD рабочих процессах, которые недоступны в Tekton TaskRun/PipelineRun CRD (например, действия после выполнения)
    • Группировать связанные нагрузки вместе (например, объединять связанные TaskRuns и PipelineRuns в единый блок)
    • Сделать долгосрочную историю Results независимой от контроллера Pipeline CRD, тем самым освобождая ресурсы etcd для выполнения запусков.
    • Хранить логи, сгенерированные TaskRun/PipelineRun, чтобы завершённые запуски можно было очищать для экономии ресурсов.

    Дополнительная информация и мотивация дизайна доступны в TEP-0021.

    Содержание

    OverviewLifecycle of ResultsData Model

    Overview

    Tekton Results состоит из двух основных компонентов:

    • gRPC API сервер с возможностью запросов через API, поддерживаемый постоянным хранилищем (см. исходный код проекта в proto/v1alpha2 для последних спецификаций API).
    • Контроллер watcher, используемый для мониторинга и отчёта об обновлениях TaskRuns и PipelineRuns в API сервер.

    Lifecycle of Results

    1. Пользователи создают TaskRuns или PipelineRuns через Kubernetes API как обычно.
    2. Results Watcher отслеживает изменения всех TaskRuns/PipelineRuns.
    3. Если TaskRun/PipelineRun изменяется, watcher обновляет (или создаёт) соответствующую Record с помощью Results API (при необходимости также создаётся Result).
      • Watcher также аннотирует исходный TaskRun/PipelineRun идентификатором.
    4. Пользователи могут напрямую получать/запрашивать данные Results/Records через API. После завершения TaskRun/PipelineRun и успешного сохранения в Results API, исходные объекты CRD можно безопасно удалить из кластера.

    Data Model

    • Запись (record) — это отдельный экземпляр данных. Обычно это данные выполнения (например, PipelineRun, TaskRun, логи), но также может ссылаться на другие данные о событиях/выполнениях. Записи разработаны для гибкой поддержки любой информации, которую инструменты хотят предоставить о CI событиях.
    • Results — агрегаторы записей, позволяющие пользователям ссылаться на группы записей как на единый объект. Например, у вас может быть Result, объединяющий следующие записи:
      • Исходное событие, которое вызвало операцию (например, pull request, push).
      • Созданный PipelineRun.
      • TaskRuns, созданные в ответ на PipelineRun.
      • Получение cloud events.
      • Получение обновлений статуса источника.

    (Примечание: в настоящее время watcher не поддерживает все эти типы данных, но это примеры данных, которые мы планируем поддерживать.)