tektoncd/pipeline

TEP-0056: Pipelines in Pipelines

Open

#7,166 opened on Sep 29, 2023

View on GitHub
 (4 comments) (2 reactions) (1 assignee)Go (1,943 forks)auto 404
area/epicarea/roadmaphelp wantedkind/featurekind/tep

Repository metrics

Stars
 (9,013 stars)
PR merge metrics
 (PR metrics pending)

Description

Summary

Pipelines in Pipelines (PinP) allows users to define and execute Pipelines within Pipelines, alongside Tasks and Custom Tasks. A PipelineTask can reference a child Pipeline using pipelineRef or embed one using pipelineSpec. The child Pipeline is executed as a child PipelineRun owned by the parent.

Scope

Features required for beta readiness per TEP-0056:

  • Ground work and PipelineSpec (API types, validation, embedded pipeline execution)
  • PipelineRef (reference by name or via resolvers, cycle detection)
  • Results propagation from child Pipelines (including When expression support)
  • Execution status for Finally Tasks
  • Timeout propagation to child PipelineRuns
  • Fine-grained timeout overrides for child PipelineRuns via pipelineRunSpecs
  • Retries for PipelineTasks with Pipelines
  • Matrix fan-out of PipelineRef
  • Workspace validation at parent PipelineRun
  • ServiceAccount propagation test coverage

Resources

Contributor guide

Research direction
Study the existing PipelineRun reconciliation logic and identify where a child PipelineRun should be created. Trace the flow from PipelineRun controller to TaskRun execution and understand how to leverage PipelineRunSpec and pipelineRef/pipelineSpec.
Tech stack
go
Domain
backendapi
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
4
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Over 1 week
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GoKubernetesTekton Pipelines
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
25