-
Notifications
You must be signed in to change notification settings - Fork 16.7k
Clarify template context for asset-triggered DAGs in airflow-core docs#61258
Merged
shahar1 merged 4 commits intoapache:mainfrom Jan 31, 2026
Merged
Clarify template context for asset-triggered DAGs in airflow-core docs#61258shahar1 merged 4 commits intoapache:mainfrom
shahar1 merged 4 commits intoapache:mainfrom
Conversation
Contributor
This PR updates the template context documentation to explicitly cover
asset-triggered DAGs in Airflow 3.
It clarifies the absence of time-based context variables such as logical_date
and ds for asset-triggered workflows, documents the correct format of
task_instance_key_str, and explains how dag_run.run_id can be used instead.
This helps prevent confusion and runtime errors when authoring templates for
asset-based workflows.
Closes #61149
Closed
2 tasks
shahar1
reviewed
Jan 30, 2026
Contributor
Author
shahar1
approved these changes
Jan 30, 2026
Contributor
shahar1
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Well done!
shahar1
changed the title
Docs: clarify template context for asset-triggered DAGs
Clarify template context for asset-triggered DAGs in docs
Jan 30, 2026
shahar1
changed the title
Clarify template context for asset-triggered DAGs in docs
Clarify template context for asset-triggered DAGs in airflow-core docs
Jan 30, 2026
shahar1
reviewed
Jan 30, 2026
|
Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions. |
shahar1
added
the
backport-to-v3-1-test
Mark PR with this label to backport to v3-1-test branch
label
Jan 31, 2026
potiuk
pushed a commit
that referenced
this pull request
Feb 3, 2026
* [v3-1-test] Add Keycloak token documentation to Security/API (#61228) (#61248)
(cherry picked from commit bb04b5d)
Co-authored-by: Bugra Ozturk
* [v3-1-test] Fix language selector state not updating on change (#61060) (#61263)
(cherry picked from commit 975cfe6)
* [v3-1-test] Clarify template context for asset-triggered DAGs in airflow-core docs (#61258) (#61282)
(cherry picked from commit f7aa502)
Co-authored-by: Rachana Dutta
Co-authored-by: kevinhongzl
* [v3-1-test] Fix flaky OTel integration test with DNS health check (#61070) (#61242) (#61286)
* Fix flaky OTel integration test with DNS health check (#61070)
* Update airflow-core/tests/integration/otel/test_otel.py
---------
(cherry picked from commit 8ac25dd)
Co-authored-by: Abhishek Mishra
Co-authored-by: Henry Chen
* [v3-1-test] Update pmc verification docs (#61271) (#61294)
* Update Helm Chart release instructions for PMC Checks
* Update KEY download instructions for PMC Checks
* Update dev/README_RELEASE_HELM_CHART.md
(cherry picked from commit c74b24a)
* [v3-1-test] update version for release command (#61260) (#61328)
(cherry picked from commit 7790482)
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
* CI: Upgrade important CI environment (#61327)
* [v3-1-test] Fix JWT token generation with unset issuer/audience config (#61278) (#61331)
* Fix JWT token generation with unset issuer/audience config
(cherry picked from commit a440d1d)
Co-authored-by: Amogh Desai
* [v3-1-test] Remove empty `apache_airflow_site.py` file (#61308)
(cherry picked from commit d65ff01)
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
---------
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Bugra Ozturk
Co-authored-by: Guan-Ming (Wesley) Chiu <105915352+guan404ming@users.noreply.github.com>
Co-authored-by: Shahar Epstein <60007259+shahar1@users.noreply.github.com>
Co-authored-by: Rachana Dutta
Co-authored-by: kevinhongzl
Co-authored-by: Abhishek Mishra
Co-authored-by: Henry Chen
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
Co-authored-by: Amogh Desai
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
(cherry picked from commit bb04b5d)
Co-authored-by: Bugra Ozturk
* [v3-1-test] Fix language selector state not updating on change (#61060) (#61263)
(cherry picked from commit 975cfe6)
* [v3-1-test] Clarify template context for asset-triggered DAGs in airflow-core docs (#61258) (#61282)
(cherry picked from commit f7aa502)
Co-authored-by: Rachana Dutta
Co-authored-by: kevinhongzl
* [v3-1-test] Fix flaky OTel integration test with DNS health check (#61070) (#61242) (#61286)
* Fix flaky OTel integration test with DNS health check (#61070)
* Update airflow-core/tests/integration/otel/test_otel.py
---------
(cherry picked from commit 8ac25dd)
Co-authored-by: Abhishek Mishra
Co-authored-by: Henry Chen
* [v3-1-test] Update pmc verification docs (#61271) (#61294)
* Update Helm Chart release instructions for PMC Checks
* Update KEY download instructions for PMC Checks
* Update dev/README_RELEASE_HELM_CHART.md
(cherry picked from commit c74b24a)
* [v3-1-test] update version for release command (#61260) (#61328)
(cherry picked from commit 7790482)
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
* CI: Upgrade important CI environment (#61327)
* [v3-1-test] Fix JWT token generation with unset issuer/audience config (#61278) (#61331)
* Fix JWT token generation with unset issuer/audience config
(cherry picked from commit a440d1d)
Co-authored-by: Amogh Desai
* [v3-1-test] Remove empty `apache_airflow_site.py` file (#61308)
(cherry picked from commit d65ff01)
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
---------
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Bugra Ozturk
Co-authored-by: Guan-Ming (Wesley) Chiu <105915352+guan404ming@users.noreply.github.com>
Co-authored-by: Shahar Epstein <60007259+shahar1@users.noreply.github.com>
Co-authored-by: Rachana Dutta
Co-authored-by: kevinhongzl
Co-authored-by: Abhishek Mishra
Co-authored-by: Henry Chen
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
Co-authored-by: Amogh Desai
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
jason810496
pushed a commit
to abhijeets25012-tech/airflow
that referenced
this pull request
Feb 3, 2026
jhgoebbert
pushed a commit
to jhgoebbert/airflow_Owen-CH-Leung
that referenced
this pull request
Feb 8, 2026
vatsrahul1001
added a commit
that referenced
this pull request
Mar 4, 2026
* [v3-1-test] Add Keycloak token documentation to Security/API (#61228) (#61248)
(cherry picked from commit bb04b5d)
Co-authored-by: Bugra Ozturk
* [v3-1-test] Fix language selector state not updating on change (#61060) (#61263)
(cherry picked from commit 975cfe6)
* [v3-1-test] Clarify template context for asset-triggered DAGs in airflow-core docs (#61258) (#61282)
(cherry picked from commit f7aa502)
Co-authored-by: Rachana Dutta
Co-authored-by: kevinhongzl
* [v3-1-test] Fix flaky OTel integration test with DNS health check (#61070) (#61242) (#61286)
* Fix flaky OTel integration test with DNS health check (#61070)
* Update airflow-core/tests/integration/otel/test_otel.py
---------
(cherry picked from commit 8ac25dd)
Co-authored-by: Abhishek Mishra
Co-authored-by: Henry Chen
* [v3-1-test] Update pmc verification docs (#61271) (#61294)
* Update Helm Chart release instructions for PMC Checks
* Update KEY download instructions for PMC Checks
* Update dev/README_RELEASE_HELM_CHART.md
(cherry picked from commit c74b24a)
* [v3-1-test] update version for release command (#61260) (#61328)
(cherry picked from commit 7790482)
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
* CI: Upgrade important CI environment (#61327)
* [v3-1-test] Fix JWT token generation with unset issuer/audience config (#61278) (#61331)
* Fix JWT token generation with unset issuer/audience config
(cherry picked from commit a440d1d)
Co-authored-by: Amogh Desai
* [v3-1-test] Remove empty `apache_airflow_site.py` file (#61308)
(cherry picked from commit d65ff01)
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
---------
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Bugra Ozturk
Co-authored-by: Guan-Ming (Wesley) Chiu <105915352+guan404ming@users.noreply.github.com>
Co-authored-by: Shahar Epstein <60007259+shahar1@users.noreply.github.com>
Co-authored-by: Rachana Dutta
Co-authored-by: kevinhongzl
Co-authored-by: Abhishek Mishra
Co-authored-by: Henry Chen
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
Co-authored-by: Amogh Desai
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
(cherry picked from commit bb04b5d)
Co-authored-by: Bugra Ozturk
* [v3-1-test] Fix language selector state not updating on change (#61060) (#61263)
(cherry picked from commit 975cfe6)
* [v3-1-test] Clarify template context for asset-triggered DAGs in airflow-core docs (#61258) (#61282)
(cherry picked from commit f7aa502)
Co-authored-by: Rachana Dutta
Co-authored-by: kevinhongzl
* [v3-1-test] Fix flaky OTel integration test with DNS health check (#61070) (#61242) (#61286)
* Fix flaky OTel integration test with DNS health check (#61070)
* Update airflow-core/tests/integration/otel/test_otel.py
---------
(cherry picked from commit 8ac25dd)
Co-authored-by: Abhishek Mishra
Co-authored-by: Henry Chen
* [v3-1-test] Update pmc verification docs (#61271) (#61294)
* Update Helm Chart release instructions for PMC Checks
* Update KEY download instructions for PMC Checks
* Update dev/README_RELEASE_HELM_CHART.md
(cherry picked from commit c74b24a)
* [v3-1-test] update version for release command (#61260) (#61328)
(cherry picked from commit 7790482)
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
* CI: Upgrade important CI environment (#61327)
* [v3-1-test] Fix JWT token generation with unset issuer/audience config (#61278) (#61331)
* Fix JWT token generation with unset issuer/audience config
(cherry picked from commit a440d1d)
Co-authored-by: Amogh Desai
* [v3-1-test] Remove empty `apache_airflow_site.py` file (#61308)
(cherry picked from commit d65ff01)
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
---------
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Bugra Ozturk
Co-authored-by: Guan-Ming (Wesley) Chiu <105915352+guan404ming@users.noreply.github.com>
Co-authored-by: Shahar Epstein <60007259+shahar1@users.noreply.github.com>
Co-authored-by: Rachana Dutta
Co-authored-by: kevinhongzl
Co-authored-by: Abhishek Mishra
Co-authored-by: Henry Chen
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
Co-authored-by: Amogh Desai
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.