用途:通过 Astro CLI 管理本地 Airflow 环境,适合需要启动、停止或重启 Airflow、查看日志、进入容器排查问题及修复常见故障的场景。
主要能力与用法:启动本地 Airflow(Web 服务位于 http://localhost:8080)使用 astro dev start;停止容器但保留数据用 astro dev stop;彻底清除并删除卷用 astro dev kill;重启全部容器用 astro dev restart,也可按组件重启,如 astro dev restart --scheduler、astro dev restart --webserver。默认凭据为 admin / admin。修改 requirements.txt、packages.txt 或 Dockerfile 后需重启。
状态与日志:查看状态用 astro dev ps;查看全部日志用 astro dev logs,指定组件用 astro dev logs --scheduler 或 astro dev logs --webserver,实时跟踪用 astro dev logs -f。进入调度器容器用 astro dev bash,也可用 astro dev run airflow info、astro dev run airflow dags list 运行 Airflow CLI 命令。
故障处理与限制:端口 8080 被占用时需停止其他容器或编辑 .astro/config.yaml;容器无法启动可先 astro dev kill 再 astro dev start;包安装失败检查 requirements.txt 语法;DAG 未出现可运行 astro dev parse 检查导入错误;磁盘不足可执行 docker system prune。重置环境执行 astro dev kill 与 astro dev start。升级 Airflow 前建议先测试兼容性,使用 astro dev upgrade-test;修改版本需编辑 Dockerfile,如 FROM quay.io/astronomer/astro-runtime:13.0.0,然后执行 astro dev kill && astro dev start。注意这些是外部 CLI 操作,VS Code 扩展内的运行时检查应改用扩展工具。相关技能包括 setting-up-astro-project、authoring-dags、testing-dags。