This guide describes the differences between v1alpha1 Tekton entities and their v1beta1 counterparts, including how to replace PipelineResources with Tasks from the Tekton Catalog.
Changes to Fields
In Tekton v1beta1, the following fields have been changed:
| Old Field | New Field |
|---|
spec.inputs.params | spec.params |
spec.inputs | Removed from Tasks |
spec.outputs | Removed from Tasks |
spec.inputs.resources | spec.resources.inputs |
spec.outputs.resources | spec.resources.outputs |
Input parameters have been moved from spec.inputs.params to spec.params.
v1beta1, input parameters have been moved from spec.inputs.params to spec.params.
# Task.yaml
spec:
inputs:
params:
- name: ADDR
description: Address to curl.
type: string
# TaskRun.yaml
spec:
inputs:
params:
- name: ADDR
value: https://example.com/foo.json
# Task.yaml
spec:
params:
- name: ADDR
description: Address to curl.
type: string
# TaskRun.yaml
spec:
params:
- name: ADDR
value: https://example.com/foo.json
Changes to PipelineResources
PipelineResources have been moved from spec.input.resources and spec.output.resources to spec.resources.inputs and spec.resources.outputs.
v1beta1, PipelineResources have been moved from spec.input.resources and spec.output.resources to spec.resources.inputs and spec.resources.outputs, respectively.
# Task.yaml
spec:
inputs:
resources:
- name: skaffold
type: git
outputs:
resources:
- name: baked-image
type: image
# TaskRun.yaml
spec:
inputs:
resources:
- name: skaffold
resourceSpec:
type: git
params:
- name: revision
value: v0.32.0
- name: url
value: https://github.com/GoogleContainerTools/skaffold
outputs:
resources:
- name: baked-image
resourceSpec:
- type: image
params:
- name: url
value: gcr.io/foo/bar
# Task.yaml
spec:
resources:
inputs:
- name: src-repo
type: git
outputs:
- name: baked-image
type: image
# TaskRun.yaml
spec:
resources:
inputs:
- name: src-repo
resourceSpec:
type: git
params:
- name: revision
value: main
- name: url
value: https://github.com/tektoncd/pipeline
outputs:
- name: baked-image
resourceSpec:
- type: image
params:
- name: url
value: gcr.io/foo/bar
Replacing PipelineResources with Tasks
See Replacing PipelineResources with Tasks for information and examples on how to replace the following PipelineResource types:
- Git resources
- Pull request resources
- GCS resources
- Image resources
- Cluster resources
For detailed examples and recommended Tasks from the Tekton Catalog, refer to the official documentation.