AI студия Владимира Ломтева
УСЛУГИПРОЕКТЫСТАТЬИБАЗА ЗНАНИЙМаркетплейсПроверить IPОбучениеПолезные сервисы

Оставьте заявку,
чтобы обсудить проект

Напишите ваш вопрос, не забудьте указать телефон. Мы перезвоним и все расскажем.

Контакты

Москва

Работаем по всей России
и миру (онлайн)

+7 (999) 760-24-41

Ежедневно с 9:00 до 21:00

v.lomtev@airassvet.ru

По вопросам сотрудничества

TelegramWhatsApp

Есть предложение?

Напишите нам в мессенджеры

© 2025 AI студия Владимира Ломтева

Политика конфиденциальностиУсловия использованияСогласие на обработку ПДн|ИНН 623412173261
    Managing Astro Local Env — Скилл для ИИ-агентов | AI Рассвет

    Managing Astro Local Env

    Manage local Airflow environment with Astro CLI (Docker and standalone modes). Use when the user wants to start, stop, or restart Airflow, view logs, query the Airflow API, troubleshoot, or fix environment issues. For project setup, see setting up astro project.

    Скиллы для разработки#GitHub#astronomer/agents#skills.sh
    Скачивания
    2
    В избранном
    0
    Комментарии
    0
    Просмотры
    3

    Установить скилл

    Добавьте инструмент одной командой или скачайте проверенный архив версии.

    npx skills add astronomer/agents --skill managing-astro-local-env
    Скачать ZIP
    Версия
    1.0.0+35b9610bb271
    Автор
    Владимир Ломтев
    Репозиторий
    astronomer/agents
    GitHub: astronomer/agents

    Как установить

    1. 1Скопируйте команду из блока установки.
    2. 2Запустите её в терминале из каталога проекта.

    Документация

    Astro Local Environment

    This skill helps you manage your local Airflow environment using the Astro CLI.

    Two modes: Docker (default, uses containers) and Standalone (Docker-free, uses a local venv — requires Airflow 3 + uv).

    To set up a new project, see the setting-up-astro-project skill. When Airflow is running, use MCP tools from authoring-dags and testing-dags skills.


    Start / Stop / Restart (Docker)

    ## Start local Airflow (webserver at http://localhost:8080)
    astro dev start
    
    ## Stop containers (preserves data)
    astro dev stop
    
    ## Kill and remove volumes (clean slate)
    astro dev kill
    
    ## Restart all containers
    astro dev restart
    
    ## Restart specific component
    astro dev restart --scheduler
    astro dev restart --webserver
    

    Default credentials: admin / admin

    Restart after modifying: requirements.txt, packages.txt, Dockerfile

    Standalone mode? See the next section.


    Standalone Mode

    Docker-free local development. Runs Airflow directly on your machine in a .venv/ managed by uv.

    Requirements: Airflow 3 (runtime 3.x), uv on PATH. Not supported on Windows.

    Plain astro dev init already pins a runtime 3.x image, so no version flag is needed. See setting-up-astro-project for project initialization.

    Start

    ## One-time: set standalone as default mode
    astro config set dev.mode standalone
    
    ## Or use the flag per invocation
    astro dev start --standalone
    
    Flag Description
    --foreground / -f Stream output in foreground
    --port / -p Override webserver port (default: 8080)
    --no-proxy Disable reverse proxy

    Stop / Kill / Restart

    ## Stop (preserves .venv)
    astro dev stop
    
    ## Kill (removes .venv and .astro/standalone/ — clean slate)
    astro dev kill
    
    ## Restart (preserves .venv for fast restart, use -k to kill first)
    astro dev restart
    

    If you used --standalone on start instead of setting the config, pass --standalone on every subsequent command too (stop, kill, restart, bash, run, logs, etc.).

    State locations: venv in .venv/, database and logs in .astro/standalone/, DAGs from dags/.


    Reverse Proxy

    Run multiple Airflow projects locally without port conflicts. Works in both Docker and standalone modes.

    Each project gets a hostname like <project-name>.localhost:6563. Visit http://localhost:6563 to see all active projects.

    ## Check proxy status and active routes
    astro dev proxy status
    
    ## Force-stop proxy (auto-restarts on next astro dev start)
    astro dev proxy stop
    
    Config Command
    Change proxy port astro config set proxy.port <port>
    Disable per-start astro dev start --no-proxy

    Default proxy port: 6563


    Check Status

    astro dev ps
    

    View Logs

    ## All logs
    astro dev logs
    
    ## Specific component
    astro dev logs --scheduler
    astro dev logs --webserver
    
    ## Follow in real-time
    astro dev logs -f
    

    Standalone: astro dev logs works the same but shows a unified log (no per-component filtering).


    Run Airflow CLI Commands

    ## Open a shell with Airflow environment
    astro dev bash
    
    ## Run Airflow CLI commands
    astro dev run airflow info
    astro dev run airflow dags list
    

    Standalone: Same commands work — bash opens a venv-activated shell, run executes in the venv.


    Querying the Airflow API

    Use astro api airflow to query a running local Airflow instance. Prefer operation IDs over URL paths.

    Defaults: localhost:8080, admin/admin (auto-detected). Override with --api-url, --username, --password.

    Discovery

    ## List all endpoints
    astro api airflow ls
    
    ## Filter by keyword
    astro api airflow ls dags
    astro api airflow ls task
    
    ## Show params and schema for an operation
    astro api airflow describe get_dag
    

    Key Flags

    Flag Purpose
    -p key=value Path parameters
    -F key=value Body/query fields (auto-converts booleans/numbers)
    -q / --jq jq filter on response
    --paginate Fetch all pages
    -X / --method Override HTTP method
    --generate Output curl command instead of executing

    DAGs

    ## List all DAGs
    astro api airflow get_dags
    
    ## Filter by pattern (SQL LIKE — use % wildcards)
    astro api airflow get_dags -F dag_id_pattern=%etl%
    
    ## Get a specific DAG
    astro api airflow get_dag -p dag_id=my_dag
    
    ## Get full details (schedule, params, etc.)
    astro api airflow get_dag_details -p dag_id=my_dag
    
    ## Pause / unpause
    astro api airflow patch_dag -p dag_id=my_dag -F is_paused=true
    astro api airflow patch_dag -p dag_id=my_dag -F is_paused=false
    
    ## View DAG source code
    astro api airflow get_dag_source -p dag_id=my_dag
    
    ## Check import errors
    astro api airflow get_import_errors
    

    DAG Runs

    ## List runs for a DAG
    astro api airflow get_dag_runs -p dag_id=my_dag
    
    ## Trigger a run
    astro api airflow trigger_dag_run -p dag_id=my_dag
    
    ## Trigger with config
    astro api airflow trigger_dag_run -p dag_id=my_dag -F conf[key]=value
    
    ## Get a specific run
    astro api airflow get_dag_run -p dag_id=my_dag -p dag_run_id=manual__2026-04-07
    
    ## Clear (re-run) a DAG run
    astro api airflow clear_dag_run -p dag_id=my_dag -p dag_run_id=manual__2026-04-07 -F dry_run=false
    

    Task Instances

    ## List task instances for a run
    astro api airflow get_task_instances -p dag_id=my_dag -p dag_run_id=manual__2026-04-07
    
    ## Use ~ as wildcard (all DAGs or all runs)
    astro api airflow get_task_instances -p dag_id=my_dag -p dag_run_id=~
    
    ## Get a specific task instance
    astro api airflow get_task_instance -p dag_id=my_dag -p dag_run_id=manual__2026-04-07 -p task_id=extract
    
    ## Clear/retry failed tasks
    astro api airflow post_clear_task_instances -p dag_id=my_dag \
      -F dag_run_id=manual__2026-04-07 -F only_failed=true -F dry_run=false
    
    ## Get task logs
    astro api airflow get_log -p dag_id=my_dag -p dag_run_id=manual__2026-04-07 \
      -p task_id=extract -p try_number=1
    

    Config & Connections

    astro api airflow get_connections
    astro api airflow get_variables
    astro api airflow get_config
    

    Filtering with jq

    ## List only DAG IDs
    astro api airflow get_dags -q '.dags[].dag_id'
    
    ## Get failed task IDs from a run
    astro api airflow get_task_instances -p dag_id=my_dag -p dag_run_id=~ \
      -q '[.task_instances[] | select(.state=="failed") | .task_id]'
    

    Troubleshooting

    Issue Solution
    Port 8080 in use Stop other containers or edit .astro/config.yaml
    Container won't start astro dev kill then astro dev start
    Package install failed Check requirements.txt syntax
    DAG not appearing Run astro dev parse to check for import errors
    Out of disk space docker system prune
    Standalone won't start Ensure uv is on PATH and runtime is 3.x
    Proxy port conflict astro config set proxy.port <port>
    .venv corrupted astro dev kill then astro dev start --standalone

    Reset Environment

    When things are broken:

    astro dev kill
    astro dev start
    

    Upgrade Airflow

    Test compatibility first

    astro dev upgrade-test
    

    Change version

    1. Edit Dockerfile:

      FROM quay.io/astronomer/astro-runtime:13.0.0
      
    2. Restart:

      astro dev kill && astro dev start
      

    Related Skills

    • setting-up-astro-project: Initialize projects and configure dependencies
    • authoring-dags: Write DAGs (uses MCP tools, requires running Airflow)
    • testing-dags: Test DAGs (uses MCP tools, requires running Airflow)
    • deploying-airflow: Deploy DAGs to production (Astro, Docker Compose, Kubernetes)

    Требования и возможности

    Источник пакета
    https://github.com/astronomer/agents/tree/35b9610bb2710c37ca11326c4cbf7818b6725fec/skills/managing-astro-local-env

    Файлы версии

    ПутьРазмерSHA256
    SKILL.md80601cbfdca7dece0478...

    Частые вопросы

    Как установить Managing Astro Local Env?
    Используйте команду npx skills add astronomer/agents --skill managing-astro-local-env или скачайте ZIP-архив.
    Можно ли скачать Managing Astro Local Env бесплатно?
    Да, опубликованную версию можно скачать из маркетплейса бесплатно.

    Похожие инструменты

    Смотреть все
    2ГИС: Статическая карта 2ГИССформировать PNG-карту с точками, линиями или полигонами.2ГИС: Пешеходный маршрут 2ГИСПостроить пешеходный маршрут между точками.2ГИС: Обратное геокодирование 2ГИСНайти адрес и объекты рядом с заданными координатами.2ГИС: Карточка организации 2ГИСПолучить подробные данные объекта по идентификатору.
    Комментарии

    Войдите, чтобы оставить комментарий.

    Комментариев пока нет.

    Установить скилл

    Добавьте инструмент одной командой или скачайте проверенный архив версии.

    npx skills add astronomer/agents --skill managing-astro-local-env
    Скачать ZIP
    Версия
    1.0.0+35b9610bb271
    Автор
    Владимир Ломтев
    Репозиторий
    astronomer/agents
    GitHub: astronomer/agents