TaskRun

A TaskRun represents a single execution of a Task. TaskRuns are how the steps specified in a Task are executed.

Resource Definition

apiVersion

string

required

tekton.dev/v1

kind

string

required

TaskRun

metadata

ObjectMeta

required

Standard Kubernetes metadata.

spec

TaskRunSpec

required

Defines the desired state of the TaskRun.

status

TaskRunStatus

Defines the observed state of the TaskRun.

TaskRunSpec

taskRef

TaskRef

Reference to the Task to execute. Mutually exclusive with taskSpec.

Show TaskRef fields

name

string

Name of the Task in the same namespace.

resolver

string

Name of the resolver to use for remote resolution (e.g., “git”, “hub”).

params

[]Param

Parameters for remote resolution.

taskSpec

TaskSpec

Inline Task specification. Mutually exclusive with taskRef.Can be disabled by setting the disable-inline-spec feature flag.

params

[]Param

Parameters to pass to the Task.See Parameter Types for details.

serviceAccountName

string

ServiceAccount to use for running the TaskRun.

workspaces

[]WorkspaceBinding

Workspace bindings for the TaskRun.See Workspace Types for details.

timeout

Duration

Time after which the TaskRun times out. Defaults to 1 hour.Format: Go duration string (e.g., “1h30m”, “90m”)

retries

integer

default:0

Number of times to retry on task failure.

status

string

Used for cancelling a TaskRun.Values:

TaskRunCancelled - Cancel the TaskRun

statusMessage

string

Human-readable status message for cancellation.

computeResources

ResourceRequirements

Compute resources to use for this TaskRun.

podTemplate

PodTemplate

Pod-specific configuration for the TaskRun’s pod.

TaskRunStatus

conditions

[]Condition

Conditions describe the current state of the TaskRun.

Show Condition fields

type

string

Type of condition. Primary type: Succeeded

status

string

Status of the condition:

True - TaskRun succeeded
False - TaskRun failed
Unknown - TaskRun is running

reason

string

Machine-readable reason for the condition.Values include: Succeeded, Failed, Running, TaskRunCancelled, TaskRunTimeout

message

string

Human-readable message describing the condition.

startTime

Time

Time when the TaskRun started executing.

completionTime

Time

Time when the TaskRun completed.

podName

string

Name of the pod executing the TaskRun.

steps

[]StepState

State of each Step in the Task.

Show StepState fields

name

string

Name of the Step.

container

string

Name of the Step’s container.

imageID

string

Image ID of the container.

waiting

ContainerStateWaiting

Details if the container is waiting.

running

ContainerStateRunning

Details if the container is running.

terminated

ContainerStateTerminated

Details if the container has terminated.

Show Terminated fields

exitCode

integer

Exit code from the container.

reason

string

Reason for termination.

startedAt

Time

When the container started.

finishedAt

Time

When the container finished.

results

[]TaskRunResult

Results produced by the TaskRun.See Result Types for details.

taskSpec

TaskSpec

The resolved Task specification that was executed.

Example

apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  name: example-taskrun
spec:
  taskRef:
    name: example-task
  params:
    - name: message
      value: "Hello from TaskRun"
  timeout: 10m

Overview

v1 Resources

Beta Resources

Common Types

Resource Definition

TaskRunSpec

TaskRunStatus

Example

Build docs developers (and LLMs) love

Overview

v1 Resources

Beta Resources

Common Types

​Resource Definition

​TaskRunSpec

​TaskRunStatus

​Example

Build docs developers (and LLMs) love

Resource Definition

TaskRunSpec

TaskRunStatus

Example