ResolutionRequest is at v1beta1 stability level.
Resource Definition
resolution.tekton.dev/v1beta1
Standard Kubernetes metadata.
spec
ResolutionRequestSpec
required
Specification for the resolution request.
Status of the resolution request.
ResolutionRequestSpec
Runtime parameters passed to the resolver to help locate the resource.Common parameters vary by resolver:Git Resolver:
url - Repository URLrevision - Branch, tag, or commit SHApathInRepo - Path to the resource file
Bundle Resolver:
bundle - OCI bundle referencename - Name of the resource in the bundlekind - Kind of resource (Task, Pipeline)
Hub Resolver:
name - Resource nameversion - Resource versioncatalog - Catalog namekind - Resource kind
See Parameter Types for details. Runtime URL passed to the resolver. This is an alpha feature.
ResolutionRequestStatus
Conditions describing the resolution state.
True - Resolution succeededFalse - Resolution failedUnknown - Resolution in progress
Reason for the current state.
The resolved content of the requested resource, inline in the ResolutionRequest.This is typically a YAML representation of a Task or Pipeline.
Source reference of the remote data including URL, digest, and entrypoint.
URI of the source (e.g., git repo URL or OCI image reference).
Content digest for verification.
Entry point within the source (e.g., file path).
Resolvers
Tekton includes several built-in resolvers:
Git Resolver
Resolves resources from git repositories.
resolver: git
params:
- name: url
value: https://github.com/tektoncd/catalog.git
- name: revision
value: main
- name: pathInRepo
value: task/git-clone/0.9/git-clone.yaml
Bundle Resolver
Resolves resources from OCI bundles.
resolver: bundle
params:
- name: bundle
value: gcr.io/tekton-releases/catalog/upstream/git-clone:0.9
- name: name
value: git-clone
- name: kind
value: Task
Hub Resolver
Resolves resources from Artifact Hub.
resolver: hub
params:
- name: catalog
value: tekton-catalog-tasks
- name: type
value: artifact
- name: kind
value: task
- name: name
value: git-clone
- name: version
value: "0.9"
Cluster Resolver
Resolves resources from the same Kubernetes cluster.
resolver: cluster
params:
- name: kind
value: Task
- name: name
value: my-task
- name: namespace
value: default
Example
ResolutionRequests are typically created automatically when using remote resolution in TaskRuns or PipelineRuns:
apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
name: git-clone-run
spec:
taskRef:
resolver: git
params:
- name: url
value: https://github.com/tektoncd/catalog.git
- name: revision
value: main
- name: pathInRepo
value: task/git-clone/0.9/git-clone.yaml