You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by ra...@apache.org on 2026/08/05 18:30:22 UTC
(airflow) branch changes-3.3.1rc1 created (now 91fb864f882)
This is an automated email from the ASF dual-hosted git repository.
vatsrahul1001 pushed a change to branch changes-3.3.1rc1
in repository https://gitbox.apache.org/repos/asf/airflow.git
at 91fb864f882 update release notes for 3.3.1rc1
This branch includes the following new commits:
new f2d091a82fe Update version to 3.3.1
new 91fb864f882 update release notes for 3.3.1rc1
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
(airflow) 02/02: update release notes for 3.3.1rc1
Posted by ra...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
vatsrahul1001 pushed a commit to branch changes-3.3.1rc1
in repository https://gitbox.apache.org/repos/asf/airflow.git
commit 91fb864f882184df7daf02172a6f086034bc04f9
Author: Rahul Vats <ra...@gmail.com>
AuthorDate: Wed Aug 5 23:58:47 2026 +0530
update release notes for 3.3.1rc1
---
RELEASE_NOTES.rst | 230 ++++++++++++++++++++++++++++++++++++++++++++++++
reproducible_build.yaml | 4 +-
2 files changed, 232 insertions(+), 2 deletions(-)
diff --git a/RELEASE_NOTES.rst b/RELEASE_NOTES.rst
index 16068b022fe..1ca27047ada 100644
--- a/RELEASE_NOTES.rst
+++ b/RELEASE_NOTES.rst
@@ -24,6 +24,236 @@
.. towncrier release notes start
+Airflow 3.3.1 (2026-08-10)
+--------------------------
+
+Significant Changes
+^^^^^^^^^^^^^^^^^^^
+
+pandas 3 changes how DataFrame XComs are stored and read back (#71169)
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+pandas 3 exposes its public classes from the ``pandas`` namespace, so a DataFrame is qualified as
+``pandas.DataFrame`` instead of ``pandas.core.frame.DataFrame``. XComs record that name alongside the
+serialized value, so the name written into the metadata database depends on the pandas version of the
+component that pushed the value. Airflow registers both names, and a DataFrame written by either
+pandas version can be read by either -- no configuration change is needed, and existing XComs stay
+readable.
+
+What you should do:
+
+* **Roll this Airflow version out to every component before pandas 3 reaches any of them** -- workers
+ in particular. A component that predates this change cannot read a DataFrame XCom written under
+ pandas 3, and fails the pull with:
+
+ .. code-block:: text
+
+ ImportError: pandas.DataFrame was not found in allow list for deserialization imports.
+ To allow it, add it to allowed_deserialization_classes in the configuration
+
+ The message points at configuration, but the allow list is not the cause and changing it does not
+ help. The rows are not corrupt: they become readable again as soon as the reader is upgraded.
+
+* **Treat a downgrade as a one-way door for those XComs.** Rolling back to an Airflow version without
+ this change strands any DataFrame XCom written while on pandas 3, with the same error, until you
+ roll forward again.
+
+* **Review Dags that inspect the ``dtypes`` of a pulled DataFrame.** The pandas version of the *reader*
+ determines what a pulled DataFrame looks like, not the version that wrote it. Under pandas 3, a
+ column of strings comes back as ``str`` rather than ``object``, and its missing values
+ come back as ``nan`` rather than ``None``. Values are unchanged, but downstream code that branches
+ on ``dtype == "object"``, checks cells with ``is None``, or compares against a reference frame with
+ ``DataFrame.equals()`` can behave differently after the upgrade.
+
+Fix 2.x to 3.0+ upgrade failure when a custom Dag bundle is configured (#70994)
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+The ``0082_3_1_0_make_bundle_name_not_nullable`` migration assigned every legacy row
+``bundle_name='dags-folder'``, so triggering a DagRun raised ``Requested bundle 'dags-folder' is
+not configured.`` on any deployment that uses a bundle other than the default ``dags-folder``.
+``DagFileProcessorManager`` now runs a one-shot, best-effort backfill at startup that routes each
+affected Dag to the correct bundle based on its file path; unmatched Dags self-heal on the next
+successful parse (or run ``airflow dags reserialize`` to force it immediately).
+
+Team scoped values of options registered as sensitive are now hidden (#71099)
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+Configuration options are registered as sensitive under their base section, so until now only the
+base spelling of an option was masked. A team scoped override -- set in a ``[<team>=<section>]``
+config file section, or through an ``AIRFLOW__<TEAM>___<SECTION>__<KEY>`` environment variable --
+was not recognized as the same option and was returned in full.
+
+Sensitivity is now decided after resolving the team scoped spelling back to the base option, so a
+team scoped value is masked exactly as the base value already was.
+
+**Behaviour changes:**
+
+- ``AirflowConfigParser.as_dict(display_sensitive=False)``, ``GET /config``,
+ ``GET /config/section/{section}/option/{option}`` and ``airflow config list`` now return
+ ``< hidden >`` for a team scoped value of an option registered as sensitive. Deployments that
+ read a team's real value through any of these will now receive the mask; use
+ ``display_sensitive=True`` where a real value is required and appropriate.
+- Team scoped ``_cmd`` and ``_secret`` entries are replaced with ``< hidden >`` in place, rather
+ than being resolved into their value and removed as they are in a base section. Resolving them
+ is not supported for a team, so the command string or secret path is no longer shown either.
+- Non team configuration is unaffected, and ``display_sensitive=True`` continues to return real
+ values.
+
+Bug Fixes
+^^^^^^^^^
+
+- Fail deferred task instances whose saved state can't be resumed, instead of leaving them stuck (#71183)
+- Fix task callbacks being skipped when ``TriggerDagRunOperator`` gets a 404 (#71083)
+- Fix task state store rejecting keys that contain slashes (#70967)
+- Fix the ``deadline_reference`` decorator's no-parentheses form (#70966)
+- Fix Dag run duration stats crash on PostgreSQL 14+ (#70964)
+- Deactivate legacy Dags with a NULL ``bundle_name`` during upgrade from 2.x to 3.x (#70662)
+- Fix deadline alerts using an outdated Dag definition (#70965)
+- Fix deadline alert crashes on dynamic or malformed intervals (#70625)
+- Fix deadline alerts that have no fixed interval (#70659)
+- Fix backfill permission checks running against the wrong backfill for some ID formats (#71090)
+- Fix database lock contention and statement timeouts caused by slow asset listeners on large fan-outs (#71065)
+- Fix errors loading a Dag callback whose module isn't importable on the current component (#71042)
+- Reject reserved XCom serialization keys submitted as JSON string literals (#69462)
+- API: Return a clear error instead of a 500 for an invalid trigger-Dag-run request (#70775)
+- Return 503 when SQLite locks during backfill creation (#69659)
+- Return 422 for an empty backfill window and stop leaving orphan rows (#69367)
+- API: Return 410 instead of 500 when setting rendered fields for a stale task instance (#69529)
+- Reject invalid partition keys in the create asset events API (#69581)
+- Reject attaching partition keys to asset alias events (#69515)
+- Reject mismatched rollup mapper and window pairings at Dag parse time (#69516)
+- CLI: Reject inverted date windows in ``airflow partitions clear`` (#69547)
+- Fix asset materialization dropping the partition date on partitioned Dag runs (#69339)
+- UI: Fix partition progress returning errors or over-reporting for keys with slashes and duplicate rows (#69844)
+- Honor catchup for historical asset events in asset-triggered Dags (#69224)
+- Fix drifting data intervals for monthly/yearly schedules with catchup disabled (#69189)
+- Fix asset watcher triggers failing to decode their arguments (#70750)
+- Optimize database queries when triggers submit asset events (#70738)
+- Prevent Triggerer crashes by speeding up cleanup of unused triggers (#70668)
+- Fix Triggerer CrashLoopBackOff when ``json_logs`` is enabled (#70669)
+- Detect and surface task-worker communication deadlocks instead of hanging (#70744)
+- Fix TaskInstance duration calculation with SQLite (#70734)
+- Fix incorrect end date, duration, and map index in task try history for retried tasks (#69458)
+- Stop skipping ``none_failed_min_one_success`` tasks in mapped task groups (#70318)
+- Fix the scheduler firing ``on_failure_callback`` for heartbeat-timed-out retries (#69824)
+- Prevent scheduler crash when process/thread are missing from the log format (#69787)
+- Fix ``TaskInstance`` mark-success downstream default (#70143)
+- Fix crash when tailing logs of a running task instance (#69521)
+- API: Return a consistent error response instead of a 500 when a database error occurs (#70236)
+- Fix Dag reparse authorization checking the wrong Dag (#70115)
+- Don't deactivate Dag bundles owned by other Dag processors (#70017)
+- Fix Dag bundle refresh using stale state (#70374)
+- Skip stored credentials when a connection test overrides host or port (#70010)
+- Fix cursor pagination dropping rows when sorting by a nullable column (#70739)
+- Filter stale Dag tags from the public API (#70746)
+- Fix Dag details active-runs count to exclude queued runs (#70511)
+- Fix environment-variable config overrides being ignored for some provider config sections (#70732)
+- CLI: Fix config ``update --option``/``--ignore-option`` never matching options (#70757)
+- CLI: Fix ``TypeError`` in ``airflow db shell`` when the database name is missing (#70752)
+- Send Airflow CLI logs to stderr for ``-o`` commands so structured output stays machine-readable (#70747)
+- Reduce Dag processor log noise from per-Dag run lookups (#69514)
+- Suppress noisy Alembic plugin setup logs (#70116)
+- Silence internal HTTP 422 deprecation warnings in logs (#70745)
+- Only resolve a team-namespaced environment secret for its own team (#70882)
+- Fix a team-scoped secret lookup that could return another team's secret for a crafted key (#71041)
+- Mask sensitive ``Variable`` values stored as JSON lists (#71069)
+- Fix secrets recorded unmasked in the audit log for bulk ``Variable``/``Connection`` updates (#71043)
+- Fix sensitive values nested inside lists, tuples, or sets not being masked in logs (#70189)
+- UI: Fix secrets not masked in the Rendered Templates view with ``KubernetesPodOperator`` (#70756)
+- Fix an open-redirect by rejecting malformed URLs in redirect validation (#70515)
+- Fix NPM vulnerabilities in the simple auth manager (#70753)
+- Bump ``structlog>=26.1.0`` and ``croniter>=6.2.2`` to fix memory leaks (#70749)
+- Fix task instance notes not being visible to state-change listeners (#70252)
+- Call listeners for a running task instance when a Dag run state is manually set (#70286)
+- Fix ``dag`` and ``note`` missing from Dag-run state-change listener events (#70245)
+- Remove a Dag Run or Task Instance note when its content is cleared (#70735)
+- Restore the pluggable email backend for task failure and retry alerts (#70129)
+- UI: Fix task states stuck stale when a run finishes quickly (#70397)
+- UI: Fix Grid view scrollbar hiding the latest Dags run (#70555)
+- UI: Fix grid/graph view topological sort for group-level and cross-group dependencies (#70591)
+- UI: Fix ``Trigger Again`` showing empty config for the selected run (#70288)
+- UI: Fix blank Assets dependency graph from missing Dag nodes (#70743)
+- UI: Fix the collapse button overlapping details panel content (#70751)
+- UI: Fix log line-number link highlighting (#69663)
+- UI: Fix partition key display and input handling (#69974)
+- UI: Fix Gantt tooltip showing the wrong end date on queued/scheduled bars (#70742)
+- UI: Make the Dag pause toggle distinguishable in dark mode (#70748)
+
+Miscellaneous
+^^^^^^^^^^^^^
+
+- UI: Show a note indicator on Dag runs in the Grid view (#70834)
+- UI: Show a saved-note indicator on task instances in the Grid view (#70829)
+- Add partition date filters to the Dag run API (#70304)
+- Add support for filtering Dags by any Dag run state (#70292)
+- Allow filtering the Dags list by failed and success runs in any run-state filter (#70293)
+- Add expand/collapse all for the Dag Run conf JSON in the Dag Runs list (#69777)
+- Show the Dag Run conf column by default in the Dag Runs list (#69604)
+- API: Allow keeping finished task states when clearing a Dag run (#69662)
+- Export ``FanOutMapper`` and wait policies from ``airflow.partition_mappers`` (#69513)
+- Add a ``task.execute`` OpenTelemetry span around task execution (#69359)
+- Add a ``run_type`` tag to the ``dagrun.duration.failed`` metric (#70731)
+- Improve error messages when a value's type cannot be serialized (for example, XCom values) (#70982)
+- Highlight user-code frames in task log tracebacks (#70375)
+- Optimize scheduling by avoiding duplicate trigger-rule upstream-count queries per pass (#70826)
+- Hide the run-on-latest-version option for non-versioned bundles (#70702)
+- Show the current page name in the browser tab title (#69656)
+- UI: Show larger Dag run and task instance counts on the dashboard (#71008)
+- UI: Refresh task details immediately when switching tasks (#71012)
+- UI: Reset the task try when switching Graph tasks (#70817)
+- UI: Add JSON validation and prettifying to the JSON editor (#70554)
+- UI: Make the Dag pause toggle update immediately on click (#70741)
+- UI: Improve Dag list rendering by deferring the pause confirmation dialog (#70025)
+- UI: Align boolean controls in the Trigger Dag form (#70963)
+- UI: Wrap long plugin source paths in the import-error dialog (#70737)
+- UI: Allow multiple routes to show active nav buttons (#70200)
+- UI: Make duration charts readable at a glance (#70197)
+- UI: Improve Grid view performance when summaries stream in (#69958)
+- UI: Improve Grid view responsiveness by avoiding a full re-render on hover (#69928)
+- UI: Fix missing glyph icons in the code editor (#69422)
+- UI: Complete missing Hebrew (``he``) translations (#70566)
+- UI: Complete missing Arabic (``ar``) translations (#70510)
+- UI: Complete the Polish (``pl``) translation (#70507)
+- UI: Add missing Greek (``el``) translations (#70471)
+- Optimize core queries by removing redundant result de-duplication (#69918)
+- Remove redundant database commits in API route handlers (#69620)
+- Make ``ResumableJobMixin`` an abstract base class (subclasses must implement its methods) (#70810)
+- UI: Add a keyboard shortcut help dialog (press ``?``) and clean up the graph/grid view (#69978)
+
+Doc Only Changes
+^^^^^^^^^^^^^^^^
+
+- Document the effect of state-store cleanup in ``ResumableJobMixin`` (#70792)
+- Document ``jwt_secret``/``_secret`` and ``LocalFilesystemBackend`` config support (#70730)
+- Clarify the ``logging_config_class`` contract and document ``REMOTE_TASK_LOG`` (#70592)
+- Clarify ``AssetAlias`` usage (#71087)
+- Clarify the ``AssetPartitionDagRun`` provisional-run docstring (#70104)
+- Clarify custom-time parameterized timetable logic (#69387)
+- Document native template rendering type coercion (#69389)
+- Update multi-node executor guidance (#69388)
+- Add a custom metrics section to the metrics docs (#70778)
+- Add Task SDK, Go and Java SDK execution architecture diagrams (#70100)
+- Add a docker-stack docs example for the venv scene (#69112)
+- Link the pkg.go.dev API reference from the Go SDK docs (#69440)
+- Link the published Java SDK API reference from the Java SDK docs (#69448)
+- Add a real example of ``CronDataIntervalTimetable`` and ``DeltaDataIntervalTimetable`` (#70434)
+- Fix incorrect code samples in the Deadline Alerts docs (#70786)
+- Fix reversed-direction examples in the ``FanOutMapper`` docs (#69511)
+- Fix documentation misusing previous/next for task relationships (#69570)
+- Fix partition-label casing (#69470)
+- Fix stale Airflow 2.0 references in ``dev/README.md`` (#70107)
+- Fix a Sphinx build error (#70761)
+- Update the description on "What is Airflow" (#71068)
+- Update local OTel Collector and Prometheus versions to support exponential histograms (#69056)
+- Simplify the API docs on pattern search (#70509)
+- Standardize Alembic migration descriptions and add a style lint (#70262)
+- UI: Complete Spanish UI translations (#70196)
+- Update French (``fr``) UI translations to 100% coverage (#70387)
+- Add missing Dutch (``nl``) translations (#70004)
+- Add missing Simplified Chinese (``zh-CN``) UI translations (#70417, #70418, #70419)
+- Fill the Taiwanese Mandarin (``zh-TW``) translation gaps (#70195, #70379, #69707)
+- Add missing Korean (``ko``) translations and backport from main (#70807, #70832)
+
Airflow 3.3.0 (2026-07-06)
--------------------------
diff --git a/reproducible_build.yaml b/reproducible_build.yaml
index 20700e52a9e..5bf84b00d18 100644
--- a/reproducible_build.yaml
+++ b/reproducible_build.yaml
@@ -1,2 +1,2 @@
-release-notes-hash: add84c9fdd1cd1565d9e920a19a0fe6a
-source-date-epoch: 1785844427
+release-notes-hash: 003dfdb3ee1e9825ee273d443c259844
+source-date-epoch: 1785954514
(airflow) 01/02: Update version to 3.3.1
Posted by ra...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
vatsrahul1001 pushed a commit to branch changes-3.3.1rc1
in repository https://gitbox.apache.org/repos/asf/airflow.git
commit f2d091a82fe5c9983737b6b83a19441dd7e74bba
Author: Rahul Vats <ra...@gmail.com>
AuthorDate: Wed Aug 5 20:29:47 2026 +0530
Update version to 3.3.1
---
README.md | 12 ++++++------
airflow-core/docs/installation/supported-versions.rst | 2 +-
airflow-core/pyproject.toml | 4 ++--
airflow-core/src/airflow/__init__.py | 2 +-
docker-stack-docs/README.md | 10 +++++-----
.../extending/add-airflow-configuration/Dockerfile | 2 +-
.../docker-examples/extending/add-apt-packages/Dockerfile | 2 +-
.../extending/add-build-essential-extend/Dockerfile | 2 +-
.../docker-examples/extending/add-providers/Dockerfile | 2 +-
.../extending/add-pypi-packages-constraints/Dockerfile | 2 +-
.../extending/add-pypi-packages-uv/Dockerfile | 2 +-
.../docker-examples/extending/add-pypi-packages/Dockerfile | 2 +-
.../docker-examples/extending/add-python-venv/Dockerfile | 2 +-
.../extending/add-requirement-packages/Dockerfile | 2 +-
.../docker-examples/extending/custom-providers/Dockerfile | 2 +-
.../docker-examples/extending/embedding-dags/Dockerfile | 2 +-
.../extending/writable-directory/Dockerfile | 2 +-
docker-stack-docs/entrypoint.rst | 14 +++++++-------
generated/PYPI_README.md | 10 +++++-----
pyproject.toml | 6 +++---
scripts/ci/prek/supported_versions.py | 2 +-
task-sdk/src/airflow/sdk/__init__.py | 2 +-
22 files changed, 44 insertions(+), 44 deletions(-)
diff --git a/README.md b/README.md
index d63db7c4218..8f572bbfb48 100644
--- a/README.md
+++ b/README.md
@@ -101,7 +101,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.3.0) | Deprecate version (2.11.2) |
+| | Main version (dev) | Stable version (3.3.1) | Deprecate version (2.11.2) |
|------------|------------------------------------|-------------------------------------|------------------------------|
| Python | 3.10, 3.11, 3.12, 3.13, 3.14 | 3.10, 3.11, 3.12, 3.13, 3.14 | 3.10, 3.11, 3.12 |
| Platform | AMD64/ARM64 | AMD64/ARM64 | AMD64/ARM64(\*) |
@@ -174,15 +174,15 @@ them to the appropriate format and workflow that your tool requires.
```bash
-pip install 'apache-airflow==3.3.0' \
- --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.3.0/constraints-3.10.txt"
+pip install 'apache-airflow==3.3.1' \
+ --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.3.1/constraints-3.10.txt"
```
2. Installing with extras (i.e., postgres, google)
```bash
-pip install 'apache-airflow[postgres,google]==3.3.0' \
- --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.3.0/constraints-3.10.txt"
+pip install 'apache-airflow[postgres,google]==3.3.1' \
+ --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.3.1/constraints-3.10.txt"
```
For information on installing provider distributions, check
@@ -296,7 +296,7 @@ Apache Airflow version life cycle:
| Version | Current Patch/Minor | State | First Release | Limited Maintenance | EOL/Terminated |
|-----------|-----------------------|-------------|-----------------|-----------------------|------------------|
-| 3 | 3.3.0 | Maintenance | Apr 22, 2025 | TBD | TBD |
+| 3 | 3.3.1 | Maintenance | Apr 22, 2025 | TBD | TBD |
| 2 | 2.11.2 | EOL | 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 |
diff --git a/airflow-core/docs/installation/supported-versions.rst b/airflow-core/docs/installation/supported-versions.rst
index f41890a78bd..2c43585ac84 100644
--- a/airflow-core/docs/installation/supported-versions.rst
+++ b/airflow-core/docs/installation/supported-versions.rst
@@ -29,7 +29,7 @@ Apache Airflow® version life cycle:
========= ===================== =========== =============== ===================== ================
Version Current Patch/Minor State First Release Limited Maintenance EOL/Terminated
========= ===================== =========== =============== ===================== ================
-3 3.3.0 Maintenance Apr 22, 2025 TBD TBD
+3 3.3.1 Maintenance Apr 22, 2025 TBD TBD
2 2.11.2 EOL 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
diff --git a/airflow-core/pyproject.toml b/airflow-core/pyproject.toml
index 36f5bc3700c..3621eb41252 100644
--- a/airflow-core/pyproject.toml
+++ b/airflow-core/pyproject.toml
@@ -64,7 +64,7 @@ classifiers = [
]
# Version is defined in src/airflow/__init__.py and it is automatically synchronized by prek hook
-version = "3.3.0"
+version = "3.3.1"
dependencies = [
"a2wsgi>=1.10.8",
@@ -151,7 +151,7 @@ dependencies = [
"typing-extensions>=4.14.1",
"universal-pathlib>=0.3.8",
"uuid6>=2024.7.10",
- "apache-airflow-task-sdk==1.3.0",
+ "apache-airflow-task-sdk==1.3.1",
# pre-installed providers
"apache-airflow-providers-common-compat>=1.7.4",
"apache-airflow-providers-common-io>=1.6.3",
diff --git a/airflow-core/src/airflow/__init__.py b/airflow-core/src/airflow/__init__.py
index 67e7de6080e..99606843156 100644
--- a/airflow-core/src/airflow/__init__.py
+++ b/airflow-core/src/airflow/__init__.py
@@ -25,7 +25,7 @@
# lib.) This is required by some IDEs to resolve the import paths.
__path__ = __import__("pkgutil").extend_path(__path__, __name__)
-__version__ = "3.3.0"
+__version__ = "3.3.1"
import os
diff --git a/docker-stack-docs/README.md b/docker-stack-docs/README.md
index a27d016428f..644d1165ebf 100644
--- a/docker-stack-docs/README.md
+++ b/docker-stack-docs/README.md
@@ -31,12 +31,12 @@ Every time a new version of Airflow is released, the images are prepared in the
[apache/airflow DockerHub](https://hub.docker.com/r/apache/airflow)
for all the supported Python versions.
-You can find the following images there (Assuming Airflow version `3.3.0`):
+You can find the following images there (Assuming Airflow version `3.3.1`):
* `apache/airflow:latest` - the latest released Airflow image with default Python version (3.12 currently)
* `apache/airflow:latest-pythonX.Y` - the latest released Airflow image with specific Python version
-* `apache/airflow:3.3.0` - the versioned Airflow image with default Python version (3.12 currently)
-* `apache/airflow:3.3.0-pythonX.Y` - the versioned Airflow image with specific Python version
+* `apache/airflow:3.3.1` - the versioned Airflow image with default Python version (3.12 currently)
+* `apache/airflow:3.3.1-pythonX.Y` - the versioned Airflow image with specific Python version
Those are "reference" regular images. They contain the most common set of extras, dependencies and providers that are
often used by the users and they are good to "try-things-out" when you want to just take Airflow for a spin,
@@ -47,8 +47,8 @@ via [Building the image](https://airflow.apache.org/docs/docker-stack/build.html
* `apache/airflow:slim-latest` - the latest released Airflow image with default Python version (3.12 currently)
* `apache/airflow:slim-latest-pythonX.Y` - the latest released Airflow image with specific Python version
-* `apache/airflow:slim-3.3.0` - the versioned Airflow image with default Python version (3.12 currently)
-* `apache/airflow:slim-3.3.0-pythonX.Y` - the versioned Airflow image with specific Python version
+* `apache/airflow:slim-3.3.1` - the versioned Airflow image with default Python version (3.12 currently)
+* `apache/airflow:slim-3.3.1-pythonX.Y` - the versioned Airflow image with specific Python version
The Apache Airflow image provided as convenience package is optimized for size, and
it provides just a bare minimal set of the extras and dependencies installed and in most cases
diff --git a/docker-stack-docs/docker-examples/extending/add-airflow-configuration/Dockerfile b/docker-stack-docs/docker-examples/extending/add-airflow-configuration/Dockerfile
index f778af5ebde..bc16b1c8acb 100644
--- a/docker-stack-docs/docker-examples/extending/add-airflow-configuration/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-airflow-configuration/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
ENV AIRFLOW__CORE__LOAD_EXAMPLES=True
ENV AIRFLOW__DATABASE__SQL_ALCHEMY_CONN=my_conn_string
# [END Dockerfile]
diff --git a/docker-stack-docs/docker-examples/extending/add-apt-packages/Dockerfile b/docker-stack-docs/docker-examples/extending/add-apt-packages/Dockerfile
index 9676403f4e8..5724d8b92bd 100644
--- a/docker-stack-docs/docker-examples/extending/add-apt-packages/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-apt-packages/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
USER root
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
diff --git a/docker-stack-docs/docker-examples/extending/add-build-essential-extend/Dockerfile b/docker-stack-docs/docker-examples/extending/add-build-essential-extend/Dockerfile
index 157fcb821bd..abdbc091f78 100644
--- a/docker-stack-docs/docker-examples/extending/add-build-essential-extend/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-build-essential-extend/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
USER root
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
diff --git a/docker-stack-docs/docker-examples/extending/add-providers/Dockerfile b/docker-stack-docs/docker-examples/extending/add-providers/Dockerfile
index ba2e1eae4b6..8702888356a 100644
--- a/docker-stack-docs/docker-examples/extending/add-providers/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-providers/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
USER root
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
diff --git a/docker-stack-docs/docker-examples/extending/add-pypi-packages-constraints/Dockerfile b/docker-stack-docs/docker-examples/extending/add-pypi-packages-constraints/Dockerfile
index 509d83d50ab..723bdde578a 100644
--- a/docker-stack-docs/docker-examples/extending/add-pypi-packages-constraints/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-pypi-packages-constraints/Dockerfile
@@ -17,6 +17,6 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
RUN pip install --no-cache-dir "apache-airflow==${AIRFLOW_VERSION}" lxml --constraint "${HOME}/constraints.txt"
# [END Dockerfile]
diff --git a/docker-stack-docs/docker-examples/extending/add-pypi-packages-uv/Dockerfile b/docker-stack-docs/docker-examples/extending/add-pypi-packages-uv/Dockerfile
index e96a9a1ebe8..afca4cc074f 100644
--- a/docker-stack-docs/docker-examples/extending/add-pypi-packages-uv/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-pypi-packages-uv/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
# The `uv` tools is Rust packaging tool that is much faster than `pip` and other installers
# Support for uv as installation tool is experimental
diff --git a/docker-stack-docs/docker-examples/extending/add-pypi-packages/Dockerfile b/docker-stack-docs/docker-examples/extending/add-pypi-packages/Dockerfile
index e9dfb588b68..e82219d02e0 100644
--- a/docker-stack-docs/docker-examples/extending/add-pypi-packages/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-pypi-packages/Dockerfile
@@ -17,6 +17,6 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
RUN pip install --no-cache-dir "apache-airflow==${AIRFLOW_VERSION}" lxml
# [END Dockerfile]
diff --git a/docker-stack-docs/docker-examples/extending/add-python-venv/Dockerfile b/docker-stack-docs/docker-examples/extending/add-python-venv/Dockerfile
index 13fe643797f..29fe1a21654 100644
--- a/docker-stack-docs/docker-examples/extending/add-python-venv/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-python-venv/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
COPY requirements.txt /
RUN python -m venv /opt/airflow/venv \
&& /opt/airflow/venv/bin/pip install --no-cache-dir -r /requirements.txt
diff --git a/docker-stack-docs/docker-examples/extending/add-requirement-packages/Dockerfile b/docker-stack-docs/docker-examples/extending/add-requirement-packages/Dockerfile
index edf33a19ea3..1ebdd92726c 100644
--- a/docker-stack-docs/docker-examples/extending/add-requirement-packages/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/add-requirement-packages/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
COPY requirements.txt /
RUN pip install --no-cache-dir "apache-airflow==${AIRFLOW_VERSION}" -r /requirements.txt
# [END Dockerfile]
diff --git a/docker-stack-docs/docker-examples/extending/custom-providers/Dockerfile b/docker-stack-docs/docker-examples/extending/custom-providers/Dockerfile
index 880c31eaea6..f08bc006a63 100644
--- a/docker-stack-docs/docker-examples/extending/custom-providers/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/custom-providers/Dockerfile
@@ -17,6 +17,6 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
RUN pip install "apache-airflow==${AIRFLOW_VERSION}" --no-cache-dir apache-airflow-providers-docker==2.5.1
# [END Dockerfile]
diff --git a/docker-stack-docs/docker-examples/extending/embedding-dags/Dockerfile b/docker-stack-docs/docker-examples/extending/embedding-dags/Dockerfile
index 578c71f863c..70f30f6d98a 100644
--- a/docker-stack-docs/docker-examples/extending/embedding-dags/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/embedding-dags/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
COPY --chown=airflow:root test_dag.py /opt/airflow/dags
diff --git a/docker-stack-docs/docker-examples/extending/writable-directory/Dockerfile b/docker-stack-docs/docker-examples/extending/writable-directory/Dockerfile
index 9573b2720af..934abb76f86 100644
--- a/docker-stack-docs/docker-examples/extending/writable-directory/Dockerfile
+++ b/docker-stack-docs/docker-examples/extending/writable-directory/Dockerfile
@@ -17,7 +17,7 @@
# This is an example Dockerfile. It is not intended for PRODUCTION use
# [START Dockerfile]
-FROM apache/airflow:3.3.0
+FROM apache/airflow:3.3.1
RUN umask 0002; \
mkdir -p ~/writeable-directory
# [END Dockerfile]
diff --git a/docker-stack-docs/entrypoint.rst b/docker-stack-docs/entrypoint.rst
index 9835b154083..afff13ca41d 100644
--- a/docker-stack-docs/entrypoint.rst
+++ b/docker-stack-docs/entrypoint.rst
@@ -132,7 +132,7 @@ if you specify extra arguments. For example:
.. code-block:: bash
- docker run -it apache/airflow:3.3.0-python3.10 bash -c "ls -la"
+ docker run -it apache/airflow:3.3.1-python3.10 bash -c "ls -la"
total 16
drwxr-xr-x 4 airflow root 4096 Jun 5 18:12 .
drwxr-xr-x 1 root root 4096 Jun 5 18:12 ..
@@ -144,7 +144,7 @@ you pass extra parameters. For example:
.. code-block:: bash
- > docker run -it apache/airflow:3.3.0-python3.10 python -c "print('test')"
+ > docker run -it apache/airflow:3.3.1-python3.10 python -c "print('test')"
test
If first argument equals to ``airflow`` - the rest of the arguments is treated as an Airflow command
@@ -152,13 +152,13 @@ to execute. Example:
.. code-block:: bash
- docker run -it apache/airflow:3.3.0-python3.10 airflow webserver
+ docker run -it apache/airflow:3.3.1-python3.10 airflow webserver
If there are any other arguments - they are simply passed to the "airflow" command
.. code-block:: bash
- > docker run -it apache/airflow:3.3.0-python3.10 help
+ > docker run -it apache/airflow:3.3.1-python3.10 help
usage: airflow [-h] GROUP_OR_COMMAND ...
Positional Arguments:
@@ -366,7 +366,7 @@ database and creating an ``admin/admin`` Admin user with the following command:
--env "_AIRFLOW_DB_MIGRATE=true" \
--env "_AIRFLOW_WWW_USER_CREATE=true" \
--env "_AIRFLOW_WWW_USER_PASSWORD=admin" \
- apache/airflow:3.3.0-python3.10 webserver
+ apache/airflow:3.3.1-python3.10 webserver
.. code-block:: bash
@@ -375,7 +375,7 @@ database and creating an ``admin/admin`` Admin user with the following command:
--env "_AIRFLOW_DB_MIGRATE=true" \
--env "_AIRFLOW_WWW_USER_CREATE=true" \
--env "_AIRFLOW_WWW_USER_PASSWORD_CMD=echo admin" \
- apache/airflow:3.3.0-python3.10 webserver
+ apache/airflow:3.3.1-python3.10 webserver
The commands above perform initialization of the SQLite database, create admin user with admin password
and Admin role. They also forward local port ``8080`` to the webserver port and finally start the webserver.
@@ -415,6 +415,6 @@ Example:
--env "_AIRFLOW_DB_MIGRATE=true" \
--env "_AIRFLOW_WWW_USER_CREATE=true" \
--env "_AIRFLOW_WWW_USER_PASSWORD_CMD=echo admin" \
- apache/airflow:3.3.0-python3.10 webserver
+ apache/airflow:3.3.1-python3.10 webserver
This method is only available starting from Docker image of Airflow 2.1.1 and above.
diff --git a/generated/PYPI_README.md b/generated/PYPI_README.md
index 44a9d9ba047..14690724a92 100644
--- a/generated/PYPI_README.md
+++ b/generated/PYPI_README.md
@@ -54,7 +54,7 @@ Use Airflow to author workflows (Dags) that orchestrate tasks. The Airflow sched
Apache Airflow is tested with:
-| | Main version (dev) | Stable version (3.3.0) | Deprecate version (2.11.2) |
+| | Main version (dev) | Stable version (3.3.1) | Deprecate version (2.11.2) |
|------------|------------------------------------|-------------------------------------|------------------------------|
| Python | 3.10, 3.11, 3.12, 3.13, 3.14 | 3.10, 3.11, 3.12, 3.13, 3.14 | 3.10, 3.11, 3.12 |
| Platform | AMD64/ARM64 | AMD64/ARM64 | AMD64/ARM64(\*) |
@@ -123,15 +123,15 @@ them to the appropriate format and workflow that your tool requires.
```bash
-pip install 'apache-airflow==3.3.0' \
- --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.3.0/constraints-3.10.txt"
+pip install 'apache-airflow==3.3.1' \
+ --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.3.1/constraints-3.10.txt"
```
2. Installing with extras (i.e., postgres, google)
```bash
-pip install 'apache-airflow[postgres,google]==3.3.0' \
- --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.3.0/constraints-3.10.txt"
+pip install 'apache-airflow[postgres,google]==3.3.1' \
+ --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.3.1/constraints-3.10.txt"
```
For information on installing provider distributions, check
diff --git a/pyproject.toml b/pyproject.toml
index ce33605869e..32af09e3b87 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -56,11 +56,11 @@ classifiers = [
]
# Version is defined in src/airflow/__init__.py and it is automatically synchronized by prek
-version = "3.3.0"
+version = "3.3.1"
dependencies = [
- "apache-airflow-task-sdk==1.3.0",
- "apache-airflow-core==3.3.0",
+ "apache-airflow-task-sdk==1.3.1",
+ "apache-airflow-core==3.3.1",
]
packages = []
diff --git a/scripts/ci/prek/supported_versions.py b/scripts/ci/prek/supported_versions.py
index 07e226e620e..c438e11d1b4 100755
--- a/scripts/ci/prek/supported_versions.py
+++ b/scripts/ci/prek/supported_versions.py
@@ -39,7 +39,7 @@ HEADERS = (
)
SUPPORTED_VERSIONS = (
- ("3", "3.3.0", "Maintenance", "Apr 22, 2025", "TBD", "TBD"),
+ ("3", "3.3.1", "Maintenance", "Apr 22, 2025", "TBD", "TBD"),
("2", "2.11.2", "EOL", "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"),
diff --git a/task-sdk/src/airflow/sdk/__init__.py b/task-sdk/src/airflow/sdk/__init__.py
index f3452389d17..15b7fdae8aa 100644
--- a/task-sdk/src/airflow/sdk/__init__.py
+++ b/task-sdk/src/airflow/sdk/__init__.py
@@ -117,7 +117,7 @@ __all__ = [
"teardown",
]
-__version__ = "1.3.0"
+__version__ = "1.3.1"
if TYPE_CHECKING:
from airflow.sdk.api.datamodels._generated import DagRunState, TaskInstanceState, TriggerRule, WeightRule