用途:帮助用户使用 Astro CLI 初始化并配置 Airflow 项目,适合新建项目、设置依赖、配置连接/变量,以及在运行前做校验。注意这些属于外部 CLI 操作,若要在 VS Code 扩展内做运行时检查,应使用扩展工具。
主要能力与用法:
- 初始化项目:运行 astro dev init,生成包含 dags/、include/、plugins/、tests/、Dockerfile、packages.txt、requirements.txt 和 airflow_settings.yaml 的项目结构。
- 添加依赖:Python 包写入 requirements.txt(如 apache-airflow-providers-snowflake==5.3.0、pandas==2.1.0、requests>=2.28.0);系统包写入 packages.txt(如 gcc、libpq-dev);也可通过自定义 Dockerfile 定制镜像,例如 FROM quay.io/astronomer/astro-runtime:12.4.0,并可用 RUN pip install --extra-index-url https://pypi.example.com/simple my-package 安装私有包。修改依赖后需运行 astro dev restart。
- 配置连接与变量:airflow_settings.yaml 会在环境启动时自动加载,其中可定义 connections(如 conn_id、conn_type、host、port、login、password、schema)、variables(variable_name、variable_value)和 pools(pool_name、pool_slot)。
- 导出/导入:astro dev object export --connections --file connections.yaml 可从运行环境导出;astro dev object import --connections --file connections.yaml 可导入到环境。
- 运行前校验:astro dev parse 可在不启动完整环境的情况下解析 DAG 以捕捉错误。
适用场景:需要快速搭建本地 Airflow 开发环境、管理依赖、初始化连接与变量、以及提交前检查 DAG 时。
限制:资料未说明具体版本兼容范围、权限要求、运行平台差异或异常处理细节,暂未提供。相关技能包括 managing-astro-local-env、authoring-dags、testing-dags。