deprecations.md

Deprecations

• Introduction
• Deprecation Table

Introduction

This doc provides a list of features in Tekton Pipelines that are deprecated or recently removed.

Deprecation Table

The following features are deprecated but have not yet been removed.

Deprecated Features	Deprecation Announcement	API Compatibility Policy	Earliest Date or Release of Removal
Several fields of Task.Step are deprecated	v0.36.0	Beta	Feb 25, 2023
ClusterTask is deprecated	v0.41.0	Beta	July 13, 2023
pipelineRef.bundle and taskRef.bundle are deprecated	v0.41.0	Alpha	July 13, 2023
The config-trusted-resources configMap is deprecated	v0.45.0	Alpha	v0.46.0
The default-cloud-events-sink setting in the config-defaults configMap is deprecated in favour of the new config-events configMap.	v0.50.0	N/A	v0.59.0
v1beta1 Tasks, TaskRuns, Pipelines, and PipelineRuns are deprecated in favor of v1	v0.50.0	Beta	v0.62.0
The disable-affinity-assistant feature flag is deprecated in favor of the coschedule feature flag	v0.51.0	N/A	April 27, 2024

v1beta1 deprecation

The v1beta1 versions of Task, TaskRun, Pipeline, and PipelineRun are deprecated in favor of the v1 versions of these APIs, as of release v0.50.0. Following the beta CRD compatibility policy, the earliest release the v1beta1 versions of these CRDs may be removed is 1 year later, or v0.62.0 (LTS). The v1beta1 client libraries will be retained until v0.62.0 has reached its end of life, 1 year later. Therefore, the earliest release the client libraries may be removed is v0.74.0, 12 months after v0.62.0.

Removed features

The features listed below have been removed but may still be supported in releases that have not reached their EOL.

Removed Feature	Removal Pull Request	Removal Date	Latest LTS Release with Support	EOL of Supported Release
The PipelineRun.Status.TaskRuns and PipelineRun.Status.Runs fields and the embedded-status feature flag along with their functionalities have been tombstoned since v0.45.	[TEP100] Remove Taskruns and Runs Fields for PipelineRunStatus	Jan 25, 2023	v0.44.0	Jan 24, 2024
PipelineResources are removed, along with the components of the API that rely on them as proposed in TEP-0074. See Removed PipelineResources related features for more info.	[TEP074] Remove Generic PipelineResources with Rest of Resources Types	Mar 8, 2023	v0.44.0	Jan 24, 2024
v1alpha1 Runs are removed, as proposed in TEP-0114, along with the feature flags enable-custom-task and custom-task-version.	TEP-0114: Remove support for v1alpha1.Run	April 7, 2023	v0.44.0	Jan 24, 2024

Removed PipelineResources related features:

The following features are removed as part of the deprecation of PipelineResources. See TEP-0074 for more information.

• the fieldstask.spec.resources, taskRun.spec.resources, pipeline.spec.resources, pipelineRun.spec.resources, and taskRun.status.cloudEvents

• images built upon PipelineResources

  • the kubeconfigwriter image used with Cluster PipelineResource
  • the imagedigestexporter image of Image PipelineResource
  • the pullrequest-init image used with Pullrequest PipelineResource
  • the gsutil image used with Storage PipelineResource

• The tekton_pipelines_controller_cloudevent_count metric

• The artifacts bucket/pvc setup by the pkg/artifacts package related with Storage PipelineResources

• The generic pipelineResources functions including inputs and outputs resources and the from type

• TaskRun.Status.ResourcesResult is deprecated and tombstoned #6301