​Workflow ​Components

Get to know the main orchestration components of a Kestra workflow.

Flow

Flow is a container for tasks and their orchestration logic.

Tasks

Tasks are the steps within a flow.

Namespace

Namespaces are a logical groupings of flows and their components.

Execution

Execute flows and view the results.

Variables

Variables are key–value pairs that let you reuse values across tasks.

Inputs

Inputs are dynamic values passed to the flow at runtime.

Outputs

Outputs let you pass data between tasks and flows.

Triggers

A trigger is a mechanism that automatically starts the execution of a flow.

Labels

Labels are key-value pairs in Kestra that let you organize flows and executions across multiple dimensions, without being restricted to a single hierarchy.

Plugin Defaults

Plugin defaults are default values applied to every task of a given type within one or more flows.

Subflows

Subflows let you build modular and reusable workflow components.

Errors

Kestra provides multiple ways to handle errors, helping you both identify issues and decide whether your flows should stop or continue running after an error.

Retries

Retries handle transient failures in your workflows.

Task timeout

A timeout defines the maximum duration a runnable task is allowed to run.

Concurrency Limits

Control how many executions of a flow can run at the same time.

Descriptions

You can document flows, inputs, outputs, tasks, and triggers by adding a description property.

Disabled flag

The disabled flag is a boolean property that lets you skip a flow, task, or trigger.

States

States control the status of your workflow execution.

SLA

Assert that your workflows meet SLAs.

Finally

Define a block of tasks that always run at the end of a flow, regardless of task status.

afterExecution

Run tasks after a flow execution completes.

Task Cache

Cache the status and outputs of computationally expensive operations.