Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Apache Airflow versions on Amazon Managed Workflows for Apache Airflow

This topic describes the Apache Airflow versions Amazon Managed Workflows for Apache Airflow supports, and best-practices for upgrading to the latest version.

About Amazon MWAA versions

Amazon MWAA builds container images that bundle Apache Airflow releases with other common binaries and Python libraries. The image uses the Apache Airflow base install for the version you specify. When you create an environment, you specify an image version to use. Once an environment is created, it keeps using the specified image version until you upgrade it to a later version.

Latest version

Amazon MWAA supports more than one Apache Airflow version. If you don't specify an image version when you create an environment, Amazon MWAA creates an environment using the latest supported version of Apache Airflow.

Apache Airflow versions

The following Apache Airflow versions are supported on Amazon Managed Workflows for Apache Airflow.

For more information about migrating your self-managed Apache Airflow deployments, or migrating an existing Amazon MWAA environment, including instructions for backing up your metadata database, refer to the Amazon MWAA Migration Guide.

Apache Airflow components

This section describes the number of Apache Airflow schedulers and workers available for each Apache Airflow version on Amazon MWAA, and provides a list of key Apache Airflow features, indicating the version that supports each feature.

Schedulers

Schedulers for Apache Airflow v2 and later:

Workers

Workers for Apache Airflow v2 and later:

Upgrading the Apache Airflow version

Amazon MWAA supports minor version upgrades. This means you can upgrade your environment from version x.1.z to x.2.z, but not to a new major version, for example, from 1.y.z to 2.y.z.

For more information, and detailed instructions on updating your workflow resources, and upgrading the environment to a new version, refer to Changing the Apache Airflow version.

Downgrading the Apache Airflow version

Amazon MWAA supports minor version downgrades to an earlier version that is still supported at the time of downgrade. This means you can downgrade your environment from version x.2.z to x.1.z, but not to a previous major version, for example, from 2.y.z to 1.y.z.

For more information, and detailed instructions on updating your workflow resources, and upgrading the environment to a new version, refer to Changing the Apache Airflow version.

Apache Airflow deprecated versions

The following table lists the deprecated versions of Apache Airflow in Amazon MWAA, along with initial release and end-of-support dates for each version. For more information about migrating to a newer version, refer to the Amazon MWAA Migration Guide.

End-of-support versions

We follow the Apache Airflow community release process and version policy on the Apache Airflow website. We are committed to supporting at least three minor versions of Apache Airflow at any given time. We will announce the end-of-support date at least 180 days in advance. This applies to each Apache Airflow minor version.

We are committed to supporting an Apache Airflow version for at least 12 months after it first becomes available.

If any Amazon MWAA environments in your account run the version nearing the end of support, we send a notice through the Health Dashboard with the end of support date.

On the end of support date:

You can continue to access your existing Amazon MWAA environments that run the associated, deprecated version of Apache Airflow at your own risk. For instructions on upgrading to a newer version of Apache Airflow, see the Amazon MWAA Migration Guide.