Skip to content

docs: update architecture overview to Airflow 3 architecture#67994

Open
JH-A-Kim wants to merge 6 commits into
apache:mainfrom
JH-A-Kim:docs-core-concepts-overview-update
Open

docs: update architecture overview to Airflow 3 architecture#67994
JH-A-Kim wants to merge 6 commits into
apache:mainfrom
JH-A-Kim:docs-core-concepts-overview-update

Conversation

@JH-A-Kim
Copy link
Copy Markdown

@JH-A-Kim JH-A-Kim commented Jun 4, 2026


Docs-only change

Description

This PR aims at updating the page: Architecture Overview from Airflow 2 architecture to Airflow 3 architecture to properly align with the current architecture.

It specifically targets a few core sections:

  • Required components
  • Basic Airflow Deployment
  • Distributed Airflow Architecture
  • Separate Dag processing Architecture

It updates them by doing the following changes:

  • Replace webserver references with API server
  • Introduce Dag bundles as a required component
  • Correct Dag processor as required in all Airflow 3 deployments
  • Update Dag file sync description
  • Remove stale "separate Dag processing"
  • Add TODO for remaining AIP-72 diagram work.
  • Replaced metadata db access connections in legend
  • Fix claim that the scheduler reads Dag files directly
  • Add Task SDK as required component of minimal installation

Sources used for update

Out of Scope

  • Diagram image updates require separate work to meet AIP-72 specification. This is tracked in the TODO comment added to the RST.
Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

Generated-by: Claude Sonnet 4.6 following the guidelines


  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

@boring-cyborg
Copy link
Copy Markdown

boring-cyborg Bot commented Jun 4, 2026

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide
Here are some useful points:

  • Pay attention to the quality of your code (ruff, mypy and type annotations). Our prek-hooks will help you with that.
  • In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example Dag that shows how users should use it.
  • Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
  • Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
  • Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
  • Be sure to read the Airflow Coding style.
  • Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
    Apache Airflow is a community-driven project and together we are making it better 🚀.
    In case of doubts contact the developers at:
    Mailing List: dev@airflow.apache.org
    Slack: https://s.apache.org/airflow-slack

@JH-A-Kim JH-A-Kim force-pushed the docs-core-concepts-overview-update branch from 7c7c12e to 51ff877 Compare June 4, 2026 04:30
@JH-A-Kim JH-A-Kim changed the title Docs core concepts overview update Update Core Concepts/Architecture Overview from Airflow 2 to Airflow 3 architecture Jun 4, 2026
@JH-A-Kim JH-A-Kim changed the title Update Core Concepts/Architecture Overview from Airflow 2 to Airflow 3 architecture docs: update architecture overview to Airflow 3 architecture Jun 4, 2026
@JH-A-Kim JH-A-Kim marked this pull request as ready for review June 4, 2026 04:41
@JH-A-Kim JH-A-Kim force-pushed the docs-core-concepts-overview-update branch from 69e65a0 to 4c2eb0a Compare June 4, 2026 05:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant