用途:将 MWAA 预置环境升级到 MWAA 支持的更新 Airflow 版本,目标版本为参数。路径规划器根据源版本与目标版本计算有序的版本跳跃列表,仅在需要时插入最新 2.11.x 过渡版本和 Python 版本切换步骤。
主要能力:根据是否需保留历史运行数据、是否保留同一环境(URL/ARN)选择部署方式——新环境升级(new-environment)、先在测试副本上演练的就地升级(in-place-rehearsed)、直接就地升级(in-place-direct)。跨大版本时用 Ruff AIR 规则扫描(ruff check --preview --select AIR .),并配合手动清单检查 Ruff 无法发现的模式;检测元数据库访问类 DAG、requirements.txt 约束、secrets backend 与插件清单,并按难度对 DAG 分批。
使用方式:分阶段执行——Phase 0 重入检查(读取 .mwaa-upgrade-plan-<env-name>.md 并恢复)、Phase 1 发现与预检、Phase 2 选择方式、Phase 3 兼容性评估、Phase 4 生成计划文件。等待 AWS 操作时须逐次轮询状态,不得用 while+sleep 阻塞。技能可通过 AWS MCP retrieve_skill 加载(用 file 参数获取引用文件)或本地安装(用相对路径读取)。
限制与安全:破坏性操作(暂停全部 DAG、删除环境、修改当前环境)需逐项确认;创建环境前须确认 Phase 4 计划;每次版本跳跃需单独确认;回滚支持 3.x 到 2.11.x 及大版本内降级,不能降级到 EOS 版本。建议最小权限 IAM,凭据使用 Secrets Manager/Parameter Store;未配置 secrets backend 时连接密码不会通过 REST API 迁移。具体命令与更多细节暂未提供。