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.
taskRun.spec.taskRef.bundle and pipelineRun.spec.pipelineRef.bundle.
The enable-bundles-resolver feature flag must be enabled to use this feature.
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.
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.
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
Removing PipelineResources
PipelineResources and the resources fields of Task, TaskRun, Pipeline, and PipelineRun have been removed.
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.
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