Version compatibility reference for Astronomer Software
Astronomer Software ships with and requires a number of adjacent technologies that support it, including Kubernetes, Helm, and Apache Airflow itself. This guide provides a reference of all required tools and versions for running Astronomer Software.
While the tables below reference the minimum compatible versions, we typically recommend running the latest versions of all tooling if and when possible.
Astronomer Software
The following table shows version compatibility information for all currently supported versions of Astronomer Software and some legacy versions. Check Astronomer Software lifecycle schedule for more information about supported versions of Astronomer Software.
| Astronomer Platform | Postgres | Python | Astro Runtime |
|---|---|---|---|
| v0.32 | 11+ | 3.6 - 3.11 (3.9-3.11 Require Airflow 2.2.0+) | All Runtime versions |
| v0.33 | 11+ | 3.6 - 3.11 (3.9-3.11 Require Airflow 2.2.0+) | All Runtime versions |
| v0.34 | 11+ | 3.6 - 3.11 (3.9-3.11 Require Airflow 2.2.0+) | All Runtime versions |
| v0.35 | 11+ | 3.6 - 3.11 (3.9-3.11 Require Airflow 2.2.0+) | All Runtime versions |
| v0.36 | 11+ | 3.6 - 3.11 (3.9-3.11 Require Airflow 2.2.0+) | All Runtime versions |
See Kubernetes version support table and policy for Astronomer platform compatibility with Kubernetes.
Astronomer recommends using the latest available version of the Astro CLI for all Software versions in most cases. To upgrade from an earlier version of the CLI to the latest, see Upgrade to Astro CLI version 1.0+.
For more detail about the changes in each Astronomer Software release, see the Astronomer Software Release Notes.
All currently supported Astronomer-distributed images are compatible with all versions of Astronomer Software. Astro Runtime maintenance is independent of Software maintenance. For more information, see Astro Runtime maintenance and lifecycle policy.
Kubernetes version support table and policy
In general, Astronomer Software will support a given version of Kubernetes through its End of Life. This includes Kubernetes upstream and cloud-managed variants like GKE, AKS, and EKS. When a version of Kubernetes reaches End of Life, support will be removed in the next major or minor release of Astronomer Software. For more information on Kubernetes versioning and release policies, refer to Kubernetes Release History or your cloud provider.
See the following table for all supported Kubernetes versions in each maintained version of Astronomer Software.
| Astronomer platform | Kubernetes 1.22 | Kubernetes 1.23 | Kubernetes 1.24 | Kubernetes 1.25 | Kubernetes 1.26 | Kubernetes 1.27 | Kubernetes 1.28 | Kubernetes 1.29 | Kubernetes 1.30 | Kubernetes 1.31 |
|---|---|---|---|---|---|---|---|---|---|---|
| 0.32.0 - 0.32.2 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||||
| 0.32.3 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| 0.32.4 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||||
| 0.32.5 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| 0.32.6 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||||
| 0.33.0 | ✔️ | ✔️ | ✔️ | ✔️ | ||||||
| 0.33.1 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| 0.33.2 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| 0.33.3 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||||
| 0.34.0 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| 0.34.1 - 0.34.2 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| 0.35.0 - 0.35.1 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||||
| 0.35.2 - 0.35.4 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| 0.36.0 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
General recommendations for Kubernetes upgrades
If there are no workloads running on the nodes you want to upgrade, there won't be an immediate impact on the Astronomer or Airflow components during the initial phase of upgrading your managed node groups. To minimize disruptions, however, perform a controlled rollout restart of the worker nodes. During your controlled rollout, monitor the health of the new nodes and workloads before decommissioning the old nodes.
Before beginning the upgrade process, ensure you have all necessary backups ready. After upgrading, verify that all Astronomer and Airflow components are running as expected on the new nodes. After the Astronomer version is compatible with the EKS/AKS Cluster, you don't need to change you Astronomer configurations or settings. However, the upgrade requires restarting the Kubelet on each node, which causes the Astro and Airflow components to also restart.
For more information on upgrading Kubernetes versions, follow the guidelines offered by your cloud provider.
Airflow chart compatibility reference
Astronomer Software Deployments utilize the Astronomer-distributed Helm chart for Apache Airflow. A Deployment's Airflow chart defines how a Deployment autoscales Pods and interacts with other components in your cluster.
Use the following table to see the Airflow Helm chart version for each supported version of Astronomer Software. To view the Airflow Helm chart for an unsupported version of Astronomer Software, open the default Astronomer Helm chart in the astronomer/astronomer repository and select the Tag that corresponds to the unsupported version. The value of airflowChartVersion is the Airflow Helm chart version.
| Astronomer platform version | Astronomer Airflow Helm chart version |
|---|---|
| 0.32.0 | 1.8.4 |
| 0.32.1 | 1.8.7 |
| 0.31.2 | 1.7.6 |
| 0.32.2 | 1.8.7 |
| 0.32.3 | 1.8.8 |
| 0.32.4 | 1.8.8 |
| 0.32.5 | 1.8.9 |
| 0.33.0 | 1.9.2 |
| 0.33.1 | 1.9.4 |
| 0.33.2 | 1.9.5 |
| 0.33.3 | 1.9.5 |
| 0.34.0 | 1.10.0 |
| 0.34.1 | 1.10.0 |
| 0.34.2 | 1.10.2 |
| 0.34.3 | 1.10.2 |
| 0.34.4 | 1.10.4 |
| 0.35.0 | 1.11.0 |
| 0.35.1 | 1.11.0 |
| 0.35.2 | 1.11.0 |
| 0.35.3 | 1.11.4 |
| 0.35.4 | 1.11.4 |
| 0.36.0 | 1.13.5 |
Legacy version compatibility reference
The following table shows version compatibility information for all versions of Astronomer Software which are no longer supported:
| Astronomer Platform | Kubernetes | Postgres | Python | Astro Runtime |
|---|---|---|---|---|
| v0.26 | 1.17, 1.18, 1.19, 1.20, 1.21 | 9.6+ | 3.6, 3.7, 3.8, 3.9 (requires AC 2.2.0+) | All Astronomer Certified versions |
| v0.27 | 1.18, 1.19, 1.20, 1.21 | 9.6+ | 3.6, 3.7, 3.8, 3.9 (requires AC 2.2.0+) | All Astronomer Certified versions |
| v0.28 | 1.19¹, 1.20¹, 1.21, 1.22, 1.23, 1.24 | 9.6+ | 3.6, 3.7, 3.8, 3.9 (requires AC 2.2.0+) | All Astronomer Certified versions |
| v0.29 | 1.19¹, 1.20¹, 1.21, 1.22, 1.23, 1.24 | 9.6+ | 3.6, 3.7, 3.8, 3.9 (requires AC 2.2.0+) | All supported Certified and Runtime versions |
| v0.30 | 1.22¹, 1.23, 1.24, 1.25, 1.26, 1.27¹ | 11+ | 3.6 - 3.11 (3.9-3.11 Require Airflow 2.2.0+) | All Runtime versions |
| v0.31 | 1.21, 1.22, 1.23, 1.24 , 1.25¹, 1.26¹ | 11.19+ | 3.6, 3.7, 3.8, 3.9 (requires Airflow 2.2.0+) | All Runtime versions |
Due to the deprecation of Dockershim, Azure does not support private Certificate Authorities (CAs) starting with Kubernetes 1.19. If your organization is using a private CA, contact Astronomer support before upgrading to Kubernetes 1.19 on Azure Kubernetes Service (AKS).
¹ Support for some Kubernetes versions is limited to specific Astronomer Software patch versions.
- Support for Kubernetes 1.19 and 1.20 ends with Astronomer Software versions 0.28.7 and 0.29.5.
- Support for Kubernetes 1.22 ends with Astronomer Software version 0.30.7.
- Support for Kubernetes 1.25 and 1.26 starts in Astronomer Software 0.31.2.
- Support for Kubernetes 1.27 starts in Astronomer Software 0.30.8.