用途:借助 af 命令行查询、管理和排查 Apache Airflow 工作流,覆盖 DAG、DAG 运行、任务日志、实例配置、系统健康与 API 探查。
主要能力:
- 实例配置:
af instance add/list/use/current/delete,支持discover(先加--dry-run预览)、配置文件分层(全局、项目共享、项目本地)与${VAR}环境变量引用。 - DAG:
af dags list/get/explore/source/pause/unpause/errors/warnings/stats。 - 运行:
af runs list/get/trigger/trigger-wait/delete/clear/diagnose。 - 任务:
af tasks list/get/instance/logs,日志支持--try、--map-index。 - 系统与配置:
af health、af config version/show/connections/variables/variable/pools/pool/plugins/providers/assets。 - 直接 API:
af api <endpoint>,另有af api ls与--filter列出端点;字段语法-F自动转换类型、-f保持字符串。 - Registry 发现:
af registry providers/modules/parameters/connections,可加--version指定版本,结果本地缓存。
使用方式:命令假定 af 已在 PATH,可通过 astro otto 运行,或 uv tool install astro-airflow-mcp 安装。也可用环境变量 AIRFLOW_API_URL、AIRFLOW_AUTH_TOKEN 或 AIRFLOW_USERNAME/AIRFLOW_PASSWORD,或 CLI 参数 --airflow-url、--token 指定实例。多数命令输出 JSON,可配合 jq 过滤。
适用场景:DAG 巡检、失败运行诊断、任务日志排查、系统健康检查、连接与变量查看、API 端点探查、编写 DAG 前核对算子签名。
限制:本地运行与部署相关流程由 Astro CLI 及相关技能负责,本技能不覆盖;缺少的安装与具体端到端步骤以原文为准,未提供部分暂未提供。使用 af instance discover 非 dry-run 会在 Astro Cloud 创建 API token,属敏感操作,须先预览并取得同意。