Remote pipeline definitions for Konflux

This repository provides remote pipeline definitions that can help ease the maintenance of Konflux build pipelines across multiple repositories.

When a component is onboarded to Konflux, two build pipelines are automatically created:

• ${component.name}-pull-request.yaml
• ${component.name}-push.yaml

Instead of maintaining inline pipeline definitions in each repository, you can use remote pipelines to centralize pipeline management.

Using remote pipelines

Remote pipelines use Pipelines as Code annotations to reference pipeline definitions from external repositories. You need to replace the pipelineSpec section with a pipelineRef and add a remote pipeline annotation.

Depending on the latest version

To always use the latest version of remote pipelines:

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  annotations:
    pipelinesascode.tekton.dev/pipeline: >
      https://github.com/RedHatInsights/konflux-pipelines/raw/main/pipelines/docker-build-oci-ta.yaml
  # Other metadata...
spec:
  params: # Your existing params
  pipelineRef:
    name: docker-build-oci-ta
  workspaces: # Your existing workspaces

Benefits:

• MintMaker will no longer open PRs to update Konflux task references
• Pipeline runs automatically use the latest version
• Minimal maintenance required

Drawback:

• Changes in remote pipelines go untested until another PR triggers a pipeline run

Depending on a specific version

To depend on a specific release version:

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  annotations:
    pipelinesascode.tekton.dev/pipeline: >
      https://github.com/RedHatInsights/konflux-pipelines/raw/v1.2.0/pipelines/docker-build-oci-ta.yaml
  # Other metadata...
spec:
  params: # Your existing params
  pipelineRef:
    name: docker-build-oci-ta
  workspaces: # Your existing workspaces

Benefits:

• MintMaker automatically opens PRs when new releases are published
• Changes are immediately tested in your repository
• You catch issues as early as possible
• Still avoid Konflux task reference updates and migrations

Drawback:

• Requires occasional PRs to update to newer versions (but automated by MintMaker)

Learn more

For complete details including MintMaker customization options and guidance on hosting remote pipelines, see the full blog post: Easing the maintenance of Konflux build pipelines.