v1beta1 to v1 Migration

Guide for migrating from Tekton v1beta1 to v1

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

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

v1

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

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

v1

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

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

v1

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.