Bundles Resolver

Resolver Type

This Resolver responds to type bundles.

Parameters

Param Name Description Example Value
serviceAccount The name of the service account to use when constructing registry credentials default
bundle The bundle url pointing at the image to fetch gcr.io/tekton-releases/catalog/upstream/golang-build:0.1
name The name of the resource to pull out of the bundle golang-build
kind The resource kind to pull out of the bundle task

Requirements

  • A cluster running Tekton Pipeline v0.40.0 or later, with the alpha feature gate enabled.
  • The built-in remote resolvers installed.
  • The enable-bundles-resolver feature flag in the resolvers-feature-flags ConfigMap in the tekton-pipelines-resolvers namespace set to true.

Configuration

This resolver uses a ConfigMap for its settings. See ../config/resolvers/bundleresolver-config.yaml for the name, namespace and defaults that the resolver ships with.

Options

Option Name Description Example Values
default-service-account The default service account name to use for bundle requests. default, someuser
default-kind The default layer kind in the bundle image. task, pipeline

Usage

Task Resolution

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: remote-task-reference
spec:
  taskRef:
    resolver: bundles
    params:
    - name: bundle
      value: docker.io/ptasci67/example-oci@sha256:053a6cb9f3711d4527dd0d37ac610e8727ec0288a898d5dfbd79b25bcaa29828
    - name: name
      value: hello-world
    - name: kind
      value: pipeline

Pipeline Resolution

Unfortunately the Tekton Catalog does not publish pipelines at the moment. Here’s an example PipelineRun that talks to a private registry but won’t work unless you tweak the bundle field to point to a registry with a pipeline in it:

apiVersion: tekton.dev/v1beta1
kind: PipelineRun
metadata:
  name: bundle-demo
spec:
  pipelineRef:
    resolver: bundles
    params:
    - name: bundle
      value: 10.96.190.208:5000/simple/pipeline:latest
    - name: name
      value: hello-pipeline
    - name: kind
      value: pipeline
  params:
  - name: username
    value: "tekton pipelines"

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License.