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 ef9e8b0e7a Update dags.rst with information on DAG pausing (#36540)
ef9e8b0e7a is described below
commit ef9e8b0e7a5d6dd932f18cd1aa48e1595821338a
Author: Raj <[email protected]>
AuthorDate: Wed Jan 3 00:54:08 2024 -0700
Update dags.rst with information on DAG pausing (#36540)
Added information on DAG behavior when its paused.
---
docs/apache-airflow/core-concepts/dags.rst | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/docs/apache-airflow/core-concepts/dags.rst
b/docs/apache-airflow/core-concepts/dags.rst
index aee35b49e9..2a7829971e 100644
--- a/docs/apache-airflow/core-concepts/dags.rst
+++ b/docs/apache-airflow/core-concepts/dags.rst
@@ -875,7 +875,10 @@ Dag can be paused via UI when it is present in the
``DAGS_FOLDER``, and schedule
the database, but the user chose to disable it via the UI. The "pause" and
"unpause" actions are available
via UI and API. Paused DAG is not scheduled by the Scheduler, but you can
trigger them via UI for
manual runs. In the UI, you can see Paused DAGs (in ``Paused`` tab). The DAGs
that are un-paused
-can be found in the ``Active`` tab.
+can be found in the ``Active`` tab. When a DAG is paused, any running tasks
are allowed to complete and all
+downstream tasks are put in to a state of "Scheduled". When the DAG is
unpaused, any "scheduled" tasks will
+begin running according to the DAG logic. DAGs with no "scheduled" tasks will
begin running according to
+their schedule.
Dag can be deactivated (do not confuse it with ``Active`` tag in the UI) by
removing them from the
``DAGS_FOLDER``. When scheduler parses the ``DAGS_FOLDER`` and misses the DAG
that it had seen
