/dagger

Primary LanguagePythonMIT LicenseMIT

Dagger

Dagger is a light framework that can convert simple yaml files into complex Airflow dags. It makes your pipelines more re-usable and more structured. Based on matching the inputs and outputs of your etl jobs it can visualise the full dependency graph of your workflows including your datasets as well.

How to install

  • virtualenv -p python3 venv
  • . venv/bin/activate
  • make install
  • dagger --help

How to install for development

  • make install-dev
  • . venv/bin/activate

How to test locally

  • Build and start airflow in docker: make test-airflow
  • Go to localhost:8080 in your browser to see airflow UI.
    • User: dev_user
    • Password: dev_user
  • Example Dagger dags are defined at tests/fixtures/config_finder/root/dags/ and mounted as the dags directory in the container

How to use it

  • Install it where airflow is running
  • Put the dagger/collect_dags.py into your airflow dags folder
  • Create a directory for your new airflow pipeline
  • With the help of dagger cli create a pipeline.yaml file in the directory: dagger init-pipeline
  • With the help of dagger cli add task yaml configurations:
    • dagger list-tasks
    • dagger init-task --type=<task_type>
  • With the help of dagger cli add your inputs and outputs to the task configuration file:
    • dagger list-ios
    • dagger init-io --type=<io_type>
  • Check your airflow UI. Airflow dag is generated automatically and dependencies are set up based on matching inputs/outputs of tasks

Credits

This package was created with Cookiecutter_ and the audreyr/cookiecutter-pypackage_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter .. _audreyr/cookiecutter-pypackage: https://github.com/audreyr/cookiecutter-pypackage