run

Elena Kostyuchenko

Definition

Runs a single task instance in a DAG.

Usage

$ airflow tasks run [-h] [--cfg-path CFG_PATH] [-d {ignore,wait,check}] [-f]
                  [-A] [-i] [-I] [-N] [-l] [--map-index MAP_INDEX] [-m]
                  [-p PICKLE] [--pool POOL] [--read-from-db] [--ship-dag]
                  [-S SUBDIR] [-v]
                  dag_id task_id execution_date_or_run_id

Arguments

Parameter Description

dag_id

ID of the DAG

task_id

ID of the task

execution_date_or_run_id

The execution_date of the DAG or run_id of the DAG run

--cfg-path

Path to config file to use instead of airflow.cfg

-d, --depends-on-past

Determine how Airflow should deal with past dependencies. Possible values:

  • check (default) — Airflow will check if the past dependencies are met for the tasks having depends_on_past=True before running them.

  • ignore — the past dependencies will be ignored.

  • wait — if depends_on_past=True, Airflow will wait until the past dependencies are met before running or skipping the task.

-f, --force

Ignore previous task instance state, re-run regardless if task has already succeeded or failed

-A, --ignore-all-dependencies

Ignores all non-critical dependencies, including ignore_ti_state and ignore_task_deps

-i, --ignore-dependencies

Ignore task-specific dependencies, e.g. upstream, depends_on_past, and retry delay dependencies

-I, --ignore-depends-on-past

Deprecated. Use -–depends-on-past ignore instead

-N, --interactive

Do not capture standard output and error streams (useful for interactive debugging)

-l, --local

Run the task using the LocalExecutor

--map-index

Mapped task index

-m, --mark-success

Mark jobs as succeeded without running them

-p, --pickle

Serialized pickle object of the entire DAG (used internally)

--pool

Resource pool to use

--read-from-db

Read DAG from DB instead of the DAG file

--ship-dag

Pickles (serializes) the DAG and ships it to the worker

-S, --subdir

File or directory location for DAGs. Defaults to [AIRFLOW_HOME]/dags, where [AIRFLOW_HOME] is the value set for AIRFLOW_HOME config in airflow.cfg

-h, --help

Print out the help manual for this command

-v, --verbose

Make logging output more verbose

Examples

Example command for running a task separately:

$ airflow tasks run tutorial print_date 2025-04-04
Found a mistake? Seleсt text and press Ctrl+Enter to report it