tektoncd/pipeline

docs: add TaskRun and PipelineRun examples for per-run resolver cache override

Open

#9,559 opened on Mar 12, 2026

View on GitHub
 (2 comments) (0 reactions) (1 assignee)Go (1,943 forks)auto 404
good first issuekind/documentation

Repository metrics

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

Description

Feature request

The resolver cache docs (bundle-resolver.md, git-resolver.md, cluster-resolver.md) explain the cache parameter and its values (always, never, auto), but the PipelineRun examples don't show the cache param.

Note: cluster-resolver.md already has TaskRun cache examples (lines 108-148) but lacks a PipelineRun one. bundle-resolver.md and git-resolver.md lack both TaskRun and PipelineRun cache examples.

Users are placing cache: never under spec.params (pipeline parameters) instead of spec.pipelineRef.params (resolver parameters). When placed under spec.params, the resolver never sees the cache override and falls back to the ConfigMap default.

Use case

A user wants to disable caching for a specific PipelineRun but puts the param in the wrong place:

# WRONG: cache param under spec.params (not passed to resolver)
spec:
  params:
    - name: cache
      value: never
  pipelineRef:
    resolver: bundles
    params:
      - name: bundle
        value: quay.io/my-org/my-bundle:latest
      - name: name
        value: my-pipeline

The docs should show the correct placement:

# CORRECT: cache param under spec.pipelineRef.params
spec:
  pipelineRef:
    resolver: bundles
    params:
      - name: bundle
        value: quay.io/my-org/my-bundle:latest
      - name: name
        value: my-pipeline
      - name: cache
        value: never

The same applies to TaskRun with spec.taskRef.params:

# CORRECT: cache param under spec.taskRef.params
spec:
  taskRef:
    resolver: bundles
    params:
      - name: bundle
        value: quay.io/my-org/my-bundle:latest
      - name: name
        value: my-task
      - name: cache
        value: never

Suggested change

Add a "Per-run cache override" example to the caching section of each resolver doc:

  • bundle-resolver.md: Add both TaskRun and PipelineRun examples with cache param
  • git-resolver.md: Add both TaskRun and PipelineRun examples with cache param
  • cluster-resolver.md: Add PipelineRun example (TaskRun examples already exist)

Include a note clarifying that the cache param must be under pipelineRef.params or taskRef.params, not spec.params.

cc @naomigelman

Contributor guide