migrating-airflow-2-to-3 - Guide for migrating Apache Airflow 2.x projects to Airflow 3.x
Helps migrate Airflow 2.x DAG code to Airflow 3.x, focusing on updates to imports, operators, hooks, context, and API usage.
Tags
Updated: 2026-09-18Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Run Ruff Airflow migration rules
- Fix detectable Airflow breaking changes
- Scan remaining migration checklist items
- Refactor metadata DB access code
- Update Airflow imports and operators
Inputs
- Airflow 2.x DAG code
- reference/migration-patterns.md
- reference/migration-checklist.md
Outputs
- Migrated Airflow 3.x DAG code
- Ruff check results
Requirements
- Ruff linter
- Airflow 2.11 or Airflow 3.x
- apache-airflow-client