v1beta1 to v1 Migration

This guide describes the differences between v1beta1 Tekton entities and their v1 counterparts, including changed fields and deprecated features.

Changes to Fields

In Tekton v1, the following fields have been changed:

Old Field	Replacement
`pipelineRun.spec.Timeout`	`pipelineRun.spec.timeouts.pipeline`
`pipelineRun.spec.taskRunSpecs.taskServiceAccountName`	`pipelineRun.spec.taskRunSpecs.serviceAccountName`
`pipelineRun.spec.taskRunSpecs.taskPodTemplate`	`pipelineRun.spec.taskRunSpecs.podTemplate`
`taskRun.status.taskResults`	`taskRun.status.results`
`pipelineRun.status.pipelineResults`	`pipelineRun.status.results`
`taskRun.spec.taskRef.bundle`	`taskRun.spec.taskRef.resolver`
`pipelineRun.spec.pipelineRef.bundle`	`pipelineRun.spec.pipelineRef.resolver`
`task.spec.resources`	Removed from `Task`
`taskrun.spec.resources`	Removed from `TaskRun`
`taskRun.status.cloudEvents`	Removed from `TaskRun`
`taskRun.status.resourcesResult`	Removed from `TaskRun`
`pipeline.spec.resources`	Removed from `Pipeline`
`pipelineRun.spec.resources`	Removed from `PipelineRun`
`pipelineRun.spec.serviceAccountName`	`pipelineRun.spec.taskRunTemplate.serviceAccountName`
`pipelineRun.spec.podTemplate`	`pipelineRun.spec.taskRunTemplate.podTemplate`
`task.spec.steps[].resources`	`task.spec.steps[].computeResources`
`task.spec.stepTemplate.resources`	`task.spec.stepTemplate.computeResources`
`task.spec.sidecars[].resources`	`task.spec.sidecars[].computeResources`
`taskRun.spec.sidecarOverrides`	`taskRun.spec.sidecarSpecs`
`taskRun.spec.stepOverrides`	`taskRun.spec.stepSpecs`
`taskRun.spec.sidecarSpecs[].resources`	`taskRun.spec.sidecarSpecs[].computeResources`
`taskRun.spec.stepSpecs[].resources`	`taskRun.spec.stepSpecs[].computeResources`

Replacing Bundle References with Bundle Resolver

taskRef.bundle and pipelineRef.bundle have been removed from v1. Use the bundle resolver instead.

The bundle resolver in remote resolution should be used instead of taskRun.spec.taskRef.bundle and pipelineRun.spec.pipelineRef.bundle. The enable-bundles-resolver feature flag must be enabled to use this feature.

v1beta1
v1

apiVersion: tekton.dev/v1beta1
kind: TaskRun
spec:
  taskRef:
    name: example-task
    bundle: python:3-alpine

apiVersion: tekton.dev/v1
kind: TaskRun
spec:
  taskRef:
    resolver: bundles
    params:
    - name: bundle
      value: python:3-alpine
    - name: name
      value: taskName
    - name: kind
      value: Task

Replacing ClusterTask with Remote Resolution

ClusterTask is deprecated. Use the cluster resolver instead.

The enable-cluster-resolver feature flag must be enabled to use this feature. The cluster resolver allows Pipelines, PipelineRuns, and TaskRuns to refer to Pipelines and Tasks defined in other namespaces in the cluster.

v1beta1
v1

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: cluster-task-reference
spec:
  taskRef:
    name: example-task
    kind: ClusterTask

apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  name: cluster-task-reference
spec:
  taskRef:
    resolver: cluster
    params:
    - name: kind
      value: task
    - name: name
      value: example-task
    - name: namespace
      value: example-namespace

For more information, see TEP-0060: Remote Resource Resolution.

Removing PipelineResources

PipelineResources and the resources fields of Task, TaskRun, Pipeline, and PipelineRun have been removed.

Please use Tasks instead. For more information, see Replacing PipelineResources.

Using TaskRunTemplate in PipelineRun

ServiceAccountName and PodTemplate are moved to TaskRunTemplate so that users can specify common configuration that will apply to all TaskRuns.

v1beta1
v1

apiVersion: tekton.dev/v1beta1
kind: PipelineRun
metadata:
  name: template-pr
spec:
  pipelineRef:
    name: clone-test-build
  serviceAccountName: build
  podTemplate:
    securityContext:
      fsGroup: 65532

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: template-pr
spec:
  pipelineRef:
    name: clone-test-build
  taskRunTemplate:
    serviceAccountName: build
    podTemplate:
      securityContext:
        fsGroup: 65532

For more information, see TEP-0119: Add taskRunTemplate in PipelineRun.

Get Started

Core Concepts

Guides

Advanced Features

Resolvers

Operations

Migration

Changes to Fields

Replacing Bundle References with Bundle Resolver

Replacing ClusterTask with Remote Resolution

Removing PipelineResources

Using TaskRunTemplate in PipelineRun

Build docs developers (and LLMs) love

Get Started

Core Concepts

Guides

Advanced Features

Resolvers

Operations

Migration

Documentation Index

​Changes to Fields

​Replacing Bundle References with Bundle Resolver

​Replacing ClusterTask with Remote Resolution

​Removing PipelineResources

​Using TaskRunTemplate in PipelineRun

Build docs developers (and LLMs) love

Changes to Fields

Replacing Bundle References with Bundle Resolver

Replacing ClusterTask with Remote Resolution

Removing PipelineResources

Using TaskRunTemplate in PipelineRun