setting-up-astro-project

Astro プロジェクトのセットアップ

このスキルでは、Astro CLI を使用して Airflow プロジェクトを初期化、設定できます。

ローカル環境を実行するには、managing-astro-local-env スキルを参照してください。 DAG を作成するには、authoring-dags スキルを参照してください。 オープンソースの代替手段： ユーザーが Astro を利用していない場合は、ローカル開発には Apache Airflow の Docker Compose クイックスタート、本番環境には Helm チャートを案内してください。デプロイ戦略については、deploying-airflow スキルを使用してください。

---

新しいプロジェクトを初期化する

astro dev init

ユーザーが特定のバージョンを明示的に指定するよう求めない限り、--airflow-version または --runtime-version は渡さないでください。 通常の astro dev init では最新の Astro Runtime が選択されます。これが適切なデフォルトです。バージョンを指定すると、学習データ内の古い値に固定されるリスクがあります。インストールされたバージョンを知りたい場合は、推測するのではなく、生成された Dockerfile を後から確認してください。

次の構成が作成されます：

project/
├── dags/                # DAG files
├── include/             # SQL, configs, supporting files
├── plugins/             # Custom Airflow plugins
├── tests/               # Unit tests
├── Dockerfile           # Image customization
├── packages.txt         # OS-level packages
├── requirements.txt     # Python packages
└── airflow_settings.yaml # Connections, variables, pools

---

依存関係の追加

Python パッケージ（requirements.txt）

apache-airflow-providers-snowflake==5.3.0
pandas==2.1.0
requests>=2.28.0

OS パッケージ（packages.txt）

gcc
libpq-dev

カスタム Dockerfile

複雑なセットアップ（プライベート PyPI、カスタムスクリプトなど）の場合：

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

環境の起動時に自動的に読み込まれます：

airflow:
  connections:
    - conn_id: my_postgres
      conn_type: postgres
      host: host.docker.internal
      port: 5432
      login: user
      password: pass
      schema: mydb

  variables:
    - variable_name: env
      variable_value: dev

  pools:
    - pool_name: limited_pool
      pool_slot: 5

エクスポート／インポート

# Export from running environment
astro dev object export --connections --file connections.yaml

# Import to environment
astro dev object import --connections --file connections.yaml

---

実行前の検証

環境全体を起動せずに DAG を解析して、エラーを検出します：

astro dev parse

---

関連スキル

• managing-astro-local-env：ローカル環境の起動、停止、トラブルシューティング
• authoring-dags：DAG の作成と検証（MCP ツールを使用）
• testing-dags：DAG のテスト（MCP ツールを使用）
• deploying-airflow：DAG を本番環境にデプロイ（Astro、Docker Compose、Kubernetes）