upgrading-mwaa-environments
Upgrades an MWAA environment to a newer Airflow version — within 2.x, within 3.x, or across the 2.x-to-3.x boundary. Computes the version-jump path, inserting the 2.11.x stepping-stone and Python-transition step when needed. Chooses an approach by whether run history and the same environment (URL/ARN) must be kept: a new-environment upgrade (blue-green), a rehearsed in-place upgrade validated on a test copy, or a direct in-place upgrade. Runs Ruff scanning and deprecation-warning log scans for 3.x moves, plus Docker validation, batched deployment, and switchover. Saves a resumable upgrade plan for multi-session work. Triggers on: upgrade MWAA, upgrade Airflow, migrate to Airflow 3, MWAA Airflow 3, Airflow 2 to 3, preserve Airflow history, keep same MWAA environment, blue-green cutover, validation environment before cutover. Not for authoring new DAGs (authoring-mwaa-workflow), debugging unrelated DAG failures (debugging-mwaa-workflow), or MWAA Serverless YAML workflows (provisioned Python DAGs only).
- Version
- 1
Pinned to revision 44ba1a545191, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/upgrading-mwaa-environments/SKILL.md
- skills/upgrading-mwaa-environments/references/airflow2-to-3-checklist.md
- skills/upgrading-mwaa-environments/references/airflow2-to-3-quick-reference.md
- skills/upgrading-mwaa-environments/references/discovery-preflight.md
- skills/upgrading-mwaa-environments/references/mwaa-version-matrix.md
- skills/upgrading-mwaa-environments/references/plan-materialization.md
- skills/upgrading-mwaa-environments/references/strategy-blue-green-fresh.md
- skills/upgrading-mwaa-environments/references/strategy-inplace-direct.md
- skills/upgrading-mwaa-environments/references/strategy-inplace-green-validated.md
- skills/upgrading-mwaa-environments/references/upgrade-engine.md
Every link opens the file at its source, pinned to the revision this page describes.