![Dispatch Logo Dispatch](https://github.com/straiforos8bsh5n/tokingsq/raw/e07045a49291/faas/vmware-dispatch/docs/assets/images/logo-large.png)
ATTENTION: Dispatch is replatforming on top of Knative. To understand what that
means for Dispatch in the near and long term, check out the roadmap.
Dispatch is a framework for deploying and managing serverless style applications. The intent is a framework
which enables developers to build applications which are defined by functions which handle business logic and services
which provide all other functionality:
- State (Databases)
- Messaging/Eventing (Queues)
- Ingress (Api-Gateways)
- Etc.
Our goal is to provide a substrate which can be built upon and extended to serve as a framework for serverless
applications. Additionally, the framework must provide tools and features which aid the developer in building,
debugging and maintaining their serverless application.
Documentation
Checkout the detailed documentation including a quickstart guide.
Architecture
The diagram below illustrates the different components which make up the Dispatch project:
![Initial Architecture initial dispatch architecture diagram](https://github.com/straiforos8bsh5n/tokingsq/raw/e07045a49291/faas/vmware-dispatch/docs/_specs/dispatch-v1-architecture.png)
Installation
Installing Dispatch is easy once you have a compatible Kubernetes installation. For instance, to deploy on minikube:
- Fetch the IP address of minikube as this will be used the host for dispatch services.
export DISPATCH_HOST=$(minikube ip)
- Configure the installation:
$ cat << EOF > config.yaml
apiGateway:
host: $DISPATCH_HOST
dispatch:
host: $DISPATCH_HOST
debug: true
skipAuth: true
EOF
- Install Dispatch:
$ dispatch install --file config.yaml
For a more complete quickstart see the developer documentation
Contributing
You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull
requests, and do our best to process them as fast as we can. If you wish to contribute code and you have not signed our
contributor license agreement (CLA), our bot will update the issue when you open a Pull
Request. For any questions about the CLA process, please
refer to our FAQ.
Before you start to code, we recommend discussing your plans through a GitHub
issue or discuss it first with the official project
maintainers via the #Dispatch Slack Channel, especially
for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you
feedback on your design, and help you find out if someone else is working on the same thing.
License
Dispatch is available under the Apache 2 license.