Dagger is a distributed, scalable, durable, and highly available orchestration engine to execute asynchronous and
synchronous long-running business logic in a scalable and resilient way.
Dagger requires Python 3.7 or later for the new async/await
_ syntax, and variable type annotations.
Here's an example of how to use the library to build and run a workflow:
import logging
from uuid import uuid1
from dagger.service.services import Dagger
from dagger.modeler.definition import *
from dagger.templates.template import *
logger = logging.getLogger(__name__)
workflow_engine = Dagger(broker="kafka://localhost:9092", store="aerospike://", datadir="/tmp/data/")
@Dagger.register_template('OrderWorkflow')
def order_template(template_name: str) -> ITemplateDAG:
# Create empty default Template
template_builder = DefaultTemplateBuilder(Dagger.app)
template_builder.set_name(template_name)
template_builder.set_type(DefaultTemplateDAGInstance)
# First process in template (first node in DAG) named waving
payment_process_builder = ProcessTemplateDagBuilder(Dagger.app)
payment_process_builder.set_name("PAYMENT")
# First task and topic in payment process
payment_command_topic = Dagger.create_topic("PAYMENT_COMMAND", key_type=bytes, value_type=bytes)
payment_command_task_template_builder = KafkaCommandTaskTemplateBuilder(Dagger.app)
payment_command_task_template_builder.set_topic(payment_command_topic)
payment_command_task_template_builder.set_type(PaymentKafkaCommandTask)
# Second task and topic in payment process
payment_topic: Topic = Dagger.create_topic("PAYMENT_LISTENER", key_type=bytes, value_type=bytes)
payment_listener_task_template_builder = KafkaListenerTaskTemplateBuilder(Dagger.app)
payment_listener_task_template_builder.set_topic(payment_topic)
payment_listener_task_template_builder.set_type(PaymentKafkaListenerTask)
# Link and build tasks in payment process (define root task and order, essentially just created a child DAG inside the parent DAG)
payment_listener_task_template = payment_listener_task_template_builder.build()
payment_command_task_template_builder.set_next(payment_listener_task_template)
payment_command_task_template = payment_command_task_template_builder.build()
payment_process_builder.set_root_task(payment_command_task_template)
payment_process_builder.set_type(DefaultProcessTemplateDAGInstance)
# Build more processes like above and link them
[...]
# Link and build processes in DAG (define root task and order) Assuming one more process called "SHIPPING" was created, this would be the flow:
shipping_template = shipping_process_builder.build()
payment_process_builder.set_next_process(shipping_template)
payment_template = payment_process_builder.build()
template_builder.set_root(payment_template)
btemplate = template_builder.build()
return btemplate
# Starts the worker
workflow_engine.main()
The register_template
decorator defines a "DAG processor" that essentially defines the various processes and child
tasks the DAG executes. In the example above the code creates a named template OrderWorkflow
and associates
a PAYMENT
process with 2 child tasks PAYMENT_LISTENER
using PaymentKafkaListenerTask
and PAYMENT_COMMAND
using the PaymentKafkaCommandTask
definition. The SHIPPING
process follows after the PAYMENT
process with
similarly named topics and processes and the template defines the root process and links them in a
DAG (Directed Acyclic Graph) structure
The application can define as many DAG'S it needs to model using the register_template
decorator. dagger populates all the DAG templates in the codebase decorated with register_template
Here's and example of how to create an instance of a specific DAG:
template = workflow_engine.get_template('OrderWorkflow')
runtime_parameters:Dict[str, str] = dict()
runtime_parameters['customer_name']= `EXAMPLE_CUSTOMER`
runtime_parameters['order_number'] = 'EXAMPLE_ORDER'
workflow_instance = await template.create_instance(uuid1(), runtime_parameters)
To begin execution of the DAG instance created above
await workflow_engine.submit(workflow_instance)
This begins the actual execution of the tasks created by the template definition and executes them in the sequence as defined in the template. Dagger supports any type of stream data: bytes, Unicode and serialized structures, but also comes with "Models" that use modern Python syntax to describe how keys and values in streams are serialized. For more details on supported models refer to https://faust-streaming.github.io/faust/userguide/models.html
Dagger has support for open telemetry. To enable open telemetry the client application has to initialise the tracer implementation and set the flag enable_telemetry while initializing dagger
Dagger is extremely easy to use. To get started applications need to install this library, define a DAG using the default templates or extending them based on the use case, creating instances of these DAG's and scheduling them for execution. The library hides all the complexity of producing and consuming from Kafka, maintaining Kafka Streams topology processing and also persistence and recovery of created tasks
Dagger is highly available and can survive network problems and server crashes. In the case of node failure, it can automatically recover the state store(representing task data) or failover to a standby node
Start more instances of your application as needed to distribute the load on the system
A single-core worker instance can already process tens of thousands of tasks every second. Dagger uses a fast key-value lookup store based on rocksDB replicated to kafka topics for fault tolerance
You can install dagger via the Wayfair artifactory or from source.
To install using pip
:
pip install wf-dagger
dagger has a dependency on faust-streaming
for kafka stream processing
dagger supports python version >= 3.7
dagger supports kafka with version >= 0.10.
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. For detailed contributing guidelines, please see CONTRIBUTING.md
Distributed under the MIT LICENSE
License. See LICENSE
for more information.
Vikram Patki - [email protected]
Project Link: https://github.com/wayfair-incubator/dagger
This template was adapted from https://github.com/othneildrew/Best-README-Template.
Check out the project documentation.
For an overview on the repository structure and how to work with the code base, read the Development Guide.