This is an automated email from the ASF dual-hosted git repository.
jason810496 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 5c967e7bcab Clarify the dags reserialize command scope (#69810)
5c967e7bcab is described below
commit 5c967e7bcabceaea5b0348ac0a57fab74c19e51e
Author: Aaron Chen <[email protected]>
AuthorDate: Sun Jul 19 22:53:56 2026 +0800
Clarify the dags reserialize command scope (#69810)
---
airflow-core/docs/howto/usage-cli.rst | 16 ++++++++++++++++
docs/spelling_wordlist.txt | 1 +
2 files changed, 17 insertions(+)
diff --git a/airflow-core/docs/howto/usage-cli.rst
b/airflow-core/docs/howto/usage-cli.rst
index fbecf38dd14..d96cf5331f9 100644
--- a/airflow-core/docs/howto/usage-cli.rst
+++ b/airflow-core/docs/howto/usage-cli.rst
@@ -334,6 +334,22 @@ For a mapping between Airflow version and Alembic revision
see :doc:`/migrations
It's highly recommended that you reserialize your Dags with ``dags
reserialize`` after you finish downgrading your Airflow environment (meaning,
after you've downgraded the Airflow version installed in your Python
environment, not immediately after you've downgraded the database).
This is to ensure that the serialized Dags are compatible with the
downgraded version of Airflow.
+.. _cli-reserialize-dags:
+
+Reserializing Dags
+------------------
+
+The ``dags reserialize`` command parses the Dag files visible to it and
updates their
+serialized representation in the metadata database. It is a maintenance
command, useful
+for example to refresh serialized Dags after upgrading or downgrading Airflow.
+
+.. note::
+
+ ``airflow dags reserialize`` serializes the Dag files visible to the
process
+ running it. It does not deploy or synchronize Dag source files, and does
not
+ replace normal Dag Processor bundle refreshes. In a distributed deployment,
+ run it from an environment that sees the same Dag bundle contents as the
Dag Processor.
+
.. _cli-export-connections:
Exporting Connections
diff --git a/docs/spelling_wordlist.txt b/docs/spelling_wordlist.txt
index f9c2156a29e..b2583212f41 100644
--- a/docs/spelling_wordlist.txt
+++ b/docs/spelling_wordlist.txt
@@ -1424,6 +1424,7 @@ requeue
requeued
requeues
reserialize
+Reserializing
resetdb
resizable
ResourceRequirements
