TEP-0114: Custom Tasks Beta - References and Specifications

[jerop]

In TEP-0114: Custom Tasks Beta, we proposed migrating Custom Tasks and Runs to beta. This issue tracks this API changes to references and specifications in Custom Tasks and Runs.

Today, embedded specs are in Run.Spec.Spec. In TEP-0114: Custom Tasks Beta, we agreed to align the embedded specs with the rest of the API such that it's CustomRun.Spec.CustomSpec.

# before
apiVersion: tekton.dev/v1alpha1
kind: Run
metadata:
  name: run-with-spec
spec:
  spec:
    apiVersion: example.dev/v1alpha1
    kind: Example
    spec:
      field1: value1
      field2: value2
# after
apiVersion: tekton.dev/v1beta1
kind: CustomRun
metadata:
  name: customrun-with-spec
spec:
  customSpec:
    apiVersion: example.dev/v1beta1
    kind: Example
    spec:
      field1: value1
      field2: value2

Today, references are in Run.Spec.Ref. In TEP-0114: Custom Tasks Beta, we agreed to align the references with the rest of the API such that it's CustomRun.Spec.CustomRef.

# before
apiVersion: tekton.dev/v1alpha1
kind: Run
metadata:
  name: run-with-reference
spec:
  ref:
    apiVersion: example.dev/v1alpha1
    kind: Example
    name: my-example
---
# after
apiVersion: tekton.dev/v1beta1
kind: CustomRun
metadata:
  name: customrun-with-reference
spec:
  customRef:
    apiVersion: example.dev/v1beta1
    kind: Example
    name: my-customtask

Note that the API for TaskRuns and PipelineRuns is:

apiVersion: tekton.dev/v1beta1
kind: PipelineRun
metadata:
  name: pipelinerun-with-ref
spec:
  pipelineRef:
    name: my-pipeline
---
apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: taskrun-with-reference
spec:
  taskRef:
    name: my-task
---
apiVersion: tekton.dev/v1beta1
kind: PipelineRun
metadata:
  name: pipelinerun-with-spec
spec:
  pipelineSpec:
    params:
      - name: param1
    tasks:
      - name: my-task
---
apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: taskrun-with-spec
spec:
  taskSpec:
    params:
      - name: param1
    steps:
      - name: my-step

[vsinghai]

/assign

[vsinghai]

/assign

[vsinghai]

This issue was resolved in #5403 , it can be closed now