mcpField
M
managing-astro-local-env

managing-astro-local-env

github.com/necatiarslanCloud & DevOps4446 installsUpdated 21w ago
Repository

About managing-astro-local-env

A skill for managing a local Airflow environment with the Astro CLI. It covers environment lifecycle, status checks, logs, container access, troubleshooting, and Airflow upgrades.

Key features

  1. 01Start, stop, and restart Airflow
  2. 02Check environment status
  3. 03View component logs
  4. 04Access containers and run Airflow CLI
  5. 05Troubleshoot common setup issues
  6. 06Test and change Airflow versions

Use cases

  1. 01Start a local Airflow environment
  2. 02Inspect scheduler or webserver logs
  3. 03Diagnose a DAG that does not appear
  4. 04Test Airflow version compatibility

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/necatiarslan/airflow-vscode-extension --skill managing-astro-local-env

After installing, type/managing-astro-local-envin Claude Code to confirm it loaded.

Details

From the project README

Astro Local Environment

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

Note: These are external CLI actions. For runtime inspection inside the VS Code extension, use the extension tools instead.

Start / Stop / Restart

# 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

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

Access Container Shell

# Bash into scheduler container
astro dev bash

# Run Airflow CLI commands
astro dev run airflow info
astro dev run airflow dags list

Troubleshooting

IssueSolution
Port 8080 in useStop other containers or edit .astro/config.yaml
Container won't startastro dev kill then astro dev start
Package install failedCheck requirements.txt syntax
DAG not appearingRun astro dev parse to check for import errors
Out of disk spacedocker system prune

Reset Environment

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
  • authoring-dags
  • testing-dags

Comments

Markdown supported