Skip to content

Update main with Airflow 3.1.0 release details #56112

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kaxil merged 3 commits into from
Sep 25, 2025
Merged

Update main with Airflow 3.1.0 release details #56112

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2344009
Update main with Airflow 3.1.0 release details
kaxil Sep 25, 2025
bb1ae59
fixup! Update main with Airflow 3.1.0 release details
kaxil Sep 25, 2025
4e8662c
fixup! fixup! Update main with Airflow 3.1.0 release details
kaxil Sep 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/1-airflow_bug_report.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ body:
the latest release or main to see if the issue is fixed before reporting it.
multiple: false
options:
- "3.0.6"
- "3.1.0"
- "2.11.0"
- "main (development)"
- "Other Airflow 2 version (please specify below)"
Expand Down
2 changes: 1 addition & 1 deletion Dockerfile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ ARG AIRFLOW_UID="50000"
ARG AIRFLOW_USER_HOME_DIR=/home/airflow

# latest released version here
ARG AIRFLOW_VERSION="3.0.6"
ARG AIRFLOW_VERSION="3.1.0"

ARG BASE_IMAGE="debian:bookworm-slim"
ARG AIRFLOW_PYTHON_VERSION="3.12.11"
Expand Down
14 changes: 7 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ Airflow is not a streaming solution, but it is often used to process real-time d

Apache Airflow is tested with:

| | Main version (dev) | Stable version (3.0.6) |
| | Main version (dev) | Stable version (3.1.0) |
|------------|------------------------------|------------------------|
| Python | 3.10, 3.11, 3.12, 3.13 | 3.9, 3.10, 3.11, 3.12 |
| Platform | AMD64/ARM64(\*) | AMD64/ARM64(\*) |
Expand Down Expand Up @@ -177,15 +177,15 @@ them to the appropriate format and workflow that your tool requires.


```bash
pip install 'apache-airflow==3.0.6' \
--constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.0.6/constraints-3.10.txt"
pip install 'apache-airflow==3.1.0' \
--constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.1.0/constraints-3.10.txt"
```

2. Installing with extras (i.e., postgres, google)

```bash
pip install 'apache-airflow[postgres,google]==3.0.6' \
--constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.0.6/constraints-3.10.txt"
pip install 'apache-airflow[postgres,google]==3.1.0' \
--constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.1.0/constraints-3.10.txt"
```

For information on installing provider distributions, check
Expand Down Expand Up @@ -275,7 +275,7 @@ packages:
Changing limits for versions of Airflow dependencies is not a breaking change on its own.
* **Airflow Providers**: SemVer rules apply to changes in the particular provider's code only.
SemVer MAJOR and MINOR versions for the packages are independent of the Airflow version.
For example, `google 4.1.0` and `amazon 3.0.6` providers can happily be installed
For example, `google 4.1.0` and `amazon 3.1.0` providers can happily be installed
with `Airflow 2.1.2`. If there are limits of cross-dependencies between providers and Airflow packages,
they are present in providers as `install_requires` limitations. We aim to keep backwards
compatibility of providers with all previously released Airflow 2 versions but
Expand All @@ -299,7 +299,7 @@ Apache Airflow version life cycle:

| Version | Current Patch/Minor | State | First Release | Limited Maintenance | EOL/Terminated |
|-----------|-----------------------|-----------|-----------------|-----------------------|------------------|
| 3 | 3.0.6 | Supported | Apr 22, 2025 | TBD | TBD |
| 3 | 3.1.0 | Supported | Apr 22, 2025 | TBD | TBD |
| 2 | 2.11.0 | Supported | Dec 17, 2020 | Oct 22, 2025 | Apr 22, 2026 |
| 1.10 | 1.10.15 | EOL | Aug 27, 2018 | Dec 17, 2020 | June 17, 2021 |
| 1.9 | 1.9.0 | EOL | Jan 03, 2018 | Aug 27, 2018 | Aug 27, 2018 |
Expand Down
517 changes: 517 additions & 0 deletions RELEASE_NOTES.rst
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion airflow-core/docs/installation/supported-versions.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Apache Airflow® version life cycle:
========= ===================== ========= =============== ===================== ================
Version Current Patch/Minor State First Release Limited Maintenance EOL/Terminated
========= ===================== ========= =============== ===================== ================
3 3.0.6 Supported Apr 22, 2025 TBD TBD
3 3.1.0 Supported Apr 22, 2025 TBD TBD
2 2.11.0 Supported Dec 17, 2020 Oct 22, 2025 Apr 22, 2026
1.10 1.10.15 EOL Aug 27, 2018 Dec 17, 2020 June 17, 2021
1.9 1.9.0 EOL Jan 03, 2018 Aug 27, 2018 Aug 27, 2018
Expand Down
1 change: 1 addition & 0 deletions docs/spelling_wordlist.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1577,6 +1577,7 @@ sched
schedulable
schedulername
schemas
scrollbar
sdk
sdks
searchpath
Expand Down
10 changes: 5 additions & 5 deletions generated/PYPI_README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Use Airflow to author workflows (Dags) that orchestrate tasks. The Airflow sched

Apache Airflow is tested with:

| | Main version (dev) | Stable version (3.0.6) |
| | Main version (dev) | Stable version (3.1.0) |
|------------|------------------------------|------------------------|
| Python | 3.10, 3.11, 3.12, 3.13 | 3.9, 3.10, 3.11, 3.12 |
| Platform | AMD64/ARM64(\*) | AMD64/ARM64(\*) |
Expand Down Expand Up @@ -130,15 +130,15 @@ them to the appropriate format and workflow that your tool requires.


```bash
pip install 'apache-airflow==3.0.6' \
--constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.0.6/constraints-3.10.txt"
pip install 'apache-airflow==3.1.0' \
--constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.1.0/constraints-3.10.txt"
```

2. Installing with extras (i.e., postgres, google)

```bash
pip install 'apache-airflow[postgres,google]==3.0.6' \
--constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.0.6/constraints-3.10.txt"
pip install 'apache-airflow[postgres,google]==3.1.0' \
--constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.1.0/constraints-3.10.txt"
```

For information on installing provider distributions, check
Expand Down
4 changes: 2 additions & 2 deletions reproducible_build.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
release-notes-hash: 5608b8ff344d72dd3417308a3d711c8a
source-date-epoch: 1756939245
release-notes-hash: 1d6d475b0c7664be9a9602f4b4ef19bd
source-date-epoch: 1758835081
2 changes: 1 addition & 1 deletion scripts/ci/prek/supported_versions.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@
)

SUPPORTED_VERSIONS = (
("3", "3.0.6", "Supported", "Apr 22, 2025", "TBD", "TBD"),
("3", "3.1.0", "Supported", "Apr 22, 2025", "TBD", "TBD"),
("2", "2.11.0", "Supported", "Dec 17, 2020", "Oct 22, 2025", "Apr 22, 2026"),
("1.10", "1.10.15", "EOL", "Aug 27, 2018", "Dec 17, 2020", "June 17, 2021"),
("1.9", "1.9.0", "EOL", "Jan 03, 2018", "Aug 27, 2018", "Aug 27, 2018"),
Expand Down