This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 568c7c1c23c Add backfill through UI to docs (#54893)
568c7c1c23c is described below
commit 568c7c1c23c06752221116d33ab4fbbc9fa4e3cb
Author: Guangyang Li <[email protected]>
AuthorDate: Mon Aug 25 06:54:19 2025 -0400
Add backfill through UI to docs (#54893)
* Add backfill through UI to docs
* fix images path
* fix images
* resize images
---------
Co-authored-by: Guangyang Li <[email protected]>
---
airflow-core/docs/core-concepts/backfill.rst | 24 +++++++++++++++--
airflow-core/docs/core-concepts/dag-run.rst | 20 ++++++++++++--
airflow-core/docs/img/ui-dark/backfill.png | Bin 97497 -> 125860 bytes
.../img/ui-dark/dag_trigger_window_single_run.png | Bin 0 -> 74262 bytes
airflow-core/docs/img/ui-light/backfill.png | Bin 99130 -> 116042 bytes
.../img/ui-light/dag_trigger_window_single_run.png | Bin 0 -> 68585 bytes
airflow-core/docs/ui.rst | 29 +++++++++++++++++++++
7 files changed, 69 insertions(+), 4 deletions(-)
diff --git a/airflow-core/docs/core-concepts/backfill.rst
b/airflow-core/docs/core-concepts/backfill.rst
index 955a3661557..8262633174a 100644
--- a/airflow-core/docs/core-concepts/backfill.rst
+++ b/airflow-core/docs/core-concepts/backfill.rst
@@ -55,8 +55,12 @@ backfill will consider creating runs for. Whether or not
they will be created
depends on your chosen reprocessing behavior and the states of any existing
runs in the range at the time you actually run the backfill.
-Example:
---------
+Example
+-------
+
+Backfill can be created from either the CLI or the UI.
+
+For CLI, below is an example command:
.. code-block:: bash
@@ -67,3 +71,19 @@ Example:
--max-active-runs 3 \
--run-backwards \
--dag-run-conf '{"my": "param"}'
+
+For UI, follow the following steps:
+
+1. Navigate to a DAG's Details page and click **Trigger**.
+2. In the pop-up window, select **Backfill**.
+3. Fill in the form:
+
+ - **Date range**: set "From" and "To" logical datetimes for the backfill
window.
+ - **Reprocess behavior**: choose one of ``Missing Runs``, ``Missing and
Errored Runs``, or ``All Runs``.
+ - **Max active runs**: limit concurrent backfill runs for this backfill.
+ - **Run backwards**: execute most recent intervals first.
+ - **Advanced Config**: optionally provide JSON ``dag_run.conf``.
+ - If the DAG is paused, you can **Unpause** it in the same window.
+
+.. image:: ../img/ui-light/backfill.png
+ :alt: Backfill pop-up window (Light Mode)
diff --git a/airflow-core/docs/core-concepts/dag-run.rst
b/airflow-core/docs/core-concepts/dag-run.rst
index 1cb121c9b72..4722ba15c0b 100644
--- a/airflow-core/docs/core-concepts/dag-run.rst
+++ b/airflow-core/docs/core-concepts/dag-run.rst
@@ -142,19 +142,35 @@ if your DAG performs catchup internally.
Backfill
----------
+--------
You may want to run the DAG for a specified historical period. For example,
a DAG is created with ``start_date`` **2024-11-21**, but another user requires
the output data from a month prior, i.e. **2024-10-21**.
This process is known as Backfill.
-This can be done through API or CLI. For CLI usage, run the command below:
+This can be done through either the UI or CLI.
+
+UI
+''
+From the DAG Details page, click **Trigger** and select **Backfill** to open
the backfill form. Set the date range, reprocess
+behavior, max active runs, optional backwards ordering, and Advanced Config.
+
+.. image:: ../img/ui-light/backfill.png
+ :alt: Backfill pop-up window (Light Mode)
+
+CLI
+'''
+For CLI usage, run the command below:
.. code-block:: bash
airflow backfill create --dag-id DAG_ID \
--start-date START_DATE \
--end-date END_DATE \
+ --reprocessing-behavior failed \
+ --max-active-runs 3 \
+ --run-backwards \
+ --dag-run-conf '{"my": "param"}'
The `backfill command <../cli-and-env-variables-ref.html#backfill>`_ will
re-run all the instances of the dag_id for all the intervals within the start
diff --git a/airflow-core/docs/img/ui-dark/backfill.png
b/airflow-core/docs/img/ui-dark/backfill.png
index e84ea82c259..8b9a41c698d 100644
Binary files a/airflow-core/docs/img/ui-dark/backfill.png and
b/airflow-core/docs/img/ui-dark/backfill.png differ
diff --git a/airflow-core/docs/img/ui-dark/dag_trigger_window_single_run.png
b/airflow-core/docs/img/ui-dark/dag_trigger_window_single_run.png
new file mode 100644
index 00000000000..f5eeab00784
Binary files /dev/null and
b/airflow-core/docs/img/ui-dark/dag_trigger_window_single_run.png differ
diff --git a/airflow-core/docs/img/ui-light/backfill.png
b/airflow-core/docs/img/ui-light/backfill.png
index 5576d7948f4..0eab89ae7b8 100644
Binary files a/airflow-core/docs/img/ui-light/backfill.png and
b/airflow-core/docs/img/ui-light/backfill.png differ
diff --git a/airflow-core/docs/img/ui-light/dag_trigger_window_single_run.png
b/airflow-core/docs/img/ui-light/dag_trigger_window_single_run.png
new file mode 100644
index 00000000000..60062d5960a
Binary files /dev/null and
b/airflow-core/docs/img/ui-light/dag_trigger_window_single_run.png differ
diff --git a/airflow-core/docs/ui.rst b/airflow-core/docs/ui.rst
index 20a91cd4922..119f5182961 100644
--- a/airflow-core/docs/ui.rst
+++ b/airflow-core/docs/ui.rst
@@ -361,6 +361,35 @@ Each node includes a visual indicator of task duration.
.. _ui-ti-view:
+DAG Trigger Window
+------------------
+
+Single Run
+''''''''''
+
+The Single Run window allows you to trigger a DAG run.
+
+.. image:: img/ui-light/dag_trigger_window_single_run.png
+ :alt: DAG Trigger Window - Single Run (Light Mode)
+
+|
+
+.. image:: img/ui-dark/dag_trigger_window_single_run.png
+ :alt: DAG Trigger Window - Single Run (Dark Mode)
+
+Backfill
+''''''''
+
+The Backfill window allows you to trigger a DAG run for past dates.
+
+.. image:: img/ui-light/backfill.png
+ :alt: DAG Trigger Window - Backfill (Light Mode)
+
+|
+
+.. image:: img/ui-dark/backfill.png
+ :alt: DAG Trigger Window - Backfill (Dark Mode)
+
Task Instance View
------------------
