docs: add TaskRun and PipelineRun examples for per-run resolver cache override
#9,559 opened on Mar 12, 2026
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
cacheparam - git-resolver.md: Add both TaskRun and PipelineRun examples with
cacheparam - 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