Skip to main content
The Hub Resolver fetches Tekton resources from the Artifact Hub and Tekton Hub catalogs, providing access to community-maintained Tasks and Pipelines.

​
Resolver Type

This resolver responds to type hub.
DEPRECATION NOTICE: Tekton Hub is deprecated. Users should migrate to Artifact Hub for discovering and managing Tekton resources.

​
Parameters

​
name
string
required
The name of the Task or Pipeline to fetch from the hub.Example: golang-build, git-clone
​
version
string
required
Version or version constraint of the resource. Must be quoted!Example: "0.5.0", ">= 0.5.0", ">= 0.7.0, < 2.0.0"
​
kind
string
default:"task"
The type of resource to fetch.Options: task, pipeline
​
catalog
string
The catalog to pull the resource from. Defaults depend on the kind and type.
  • Default for tasks: tekton-catalog-tasks
  • Default for pipelines: tekton-catalog-pipelines
Example: tekton-catalog-tasks
​
type
string
default:"artifact"
The type of Hub to pull from.Options: artifact (recommended), tekton (deprecated)

​
Requirements

  • A cluster running Tekton Pipeline v0.41.0 or later
  • Built-in remote resolvers installed
  • The enable-hub-resolver feature flag set to true in the resolvers-feature-flags ConfigMap
  • Beta features enabled

​
Configuration

The Hub Resolver uses the hubresolver-config ConfigMap in the tekton-pipelines-resolvers namespace.

​
Configuration Options

default-tekton-hub-catalog

Default Tekton Hub catalog (e.g., Tekton)

default-artifact-hub-task-catalog

Default Artifact Hub catalog for tasks (e.g., tekton-catalog-tasks)

default-artifact-hub-pipeline-catalog

Default Artifact Hub catalog for pipelines (e.g., tekton-catalog-pipelines)

default-kind

Default resource kind (e.g., task, pipeline)

default-type

Default hub type (e.g., artifact, tekton)

​
Configuring Hub API Endpoints

For Artifact Hub (default), the resolver uses https://artifacthub.io/ by default. Configure a custom endpoint using the ARTIFACT_HUB_API environment variable: 
env:
- name: ARTIFACT_HUB_API
  value: "https://artifacthub.io/"
For Tekton Hub (deprecated), the resolver uses https://api.hub.tekton.dev by default. Configure a custom endpoint using the TEKTON_HUB_API environment variable: 
env:
- name: TEKTON_HUB_API
  value: "https://api.private.hub.instance.dev"

​
Versioning

The Hub Resolver supports semantic versioning:
  • Artifact Hub: Uses full semver (<major>.<minor>.0)
  • Tekton Hub: Uses simplified semver (<major>.<minor>)
Both formats are accepted, and the resolver maps the version to the expected format.

​
Version Constraints

You can specify version constraints using the go-version syntax:
ConstraintDescription
"0.5.0"Exact version
">= 0.7.0"Minimum version
">= 0.7.0, < 2.0.0"Version range
"~> 0.7"Pessimistic constraint (>= 0.7, < 1.0)

​
Usage Examples

​
Task Resolution from Artifact Hub

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: hub-task-run
spec:
  taskRef:
    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.6"

​
Task Resolution with Version Constraint

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: hub-task-constraint
spec:
  taskRef:
    resolver: hub
    params:
    - name: name
      value: git-clone
    - name: version
      value: ">= 0.7.0"
This will select the latest git-clone task that is greater than or equal to version 0.7.0.

​
Task Resolution with Version Range

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: hub-task-range
spec:
  taskRef:
    resolver: hub
    params:
    - name: name
      value: git-clone
    - name: version
      value: ">= 0.7.0, < 2.0.0"
This will select the latest git-clone task that is greater than or equal to 0.7.0 and less than 2.0.0. For example, if version 0.9.0 is the latest available, it will be selected.

​
Pipeline Resolution from Artifact Hub

apiVersion: tekton.dev/v1beta1
kind: PipelineRun
metadata:
  name: hub-pipeline-run
spec:
  pipelineRef:
    resolver: hub
    params:
    - name: catalog
      value: tekton-catalog-pipelines
    - name: type
      value: artifact
    - name: kind
      value: pipeline
    - name: name
      value: buildpacks
    - name: version
      value: "0.1"
  # Note: the buildpacks pipeline requires parameters

​
Task Resolution from Tekton Hub (Deprecated)

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: tekton-hub-task
spec:
  taskRef:
    resolver: hub
    params:
    - name: catalog
      value: Tekton
    - name: type
      value: tekton
    - name: kind
      value: task
    - name: name
      value: git-clone
    - name: version
      value: "0.6"

​
Using Default Values

When using default configuration, you can omit optional parameters: 
apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: hub-minimal
spec:
  taskRef:
    resolver: hub
    params:
    - name: name
      value: git-clone
    - name: version
      value: "0.6"
    # kind defaults to "task"
    # type defaults to "artifact"
    # catalog defaults to "tekton-catalog-tasks" for tasks

​
Version Constraint Examples

params:
  - name: name
    value: git-clone
  - name: version
    value: "0.7.0"
Always wrap version numbers and constraints in quotes to ensure proper YAML parsing.

​
Comparison: Artifact Hub vs Tekton Hub

FeatureArtifact HubTekton Hub
StatusRecommendedDeprecated
Default URLhttps://artifacthub.io/https://api.hub.tekton.dev
VersioningFull semver (0.6.0)Simplified semver (0.6)
Type valueartifacttekton
Task catalogtekton-catalog-tasksTekton
Pipeline catalogtekton-catalog-pipelinesTekton
Migrate to Artifact Hub for the best experience. See the migration guide for details.

Build docs developers (and LLMs) love

Get started for freeTalk to us