Cadence is a distributed, scalable, durable, and highly available orchestration engine to execute asynchronous long-running business logic in a scalable and resilient way.
Permalink
Failed to load latest commit information.
.gen/go Support events v2 for workflow history (#1218) Nov 13, 2018
client Start cadence client worker upon worker role startup (#1244) Nov 14, 2018
cmd Start cadence client worker upon worker role startup (#1244) Nov 14, 2018
common Make worker config dynamic (#1253) Nov 15, 2018
config Make worker required service for cadence startup (#1228) Nov 8, 2018
docker Make worker required service for cadence startup (#1228) Nov 8, 2018
host Make worker config dynamic (#1253) Nov 15, 2018
hostxdc Support events v2 for workflow history (#1218) Nov 13, 2018
idl/github.com/uber/cadence Support events v2 for workflow history (#1218) Nov 13, 2018
schema Start cadence client worker upon worker role startup (#1244) Nov 14, 2018
service Do not start client worker as part of worker role (#1254) Nov 15, 2018
store add copyright header to all files (#183) May 15, 2017
tools Start cadence client worker upon worker role startup (#1244) Nov 14, 2018
.gitignore Move from glide to dep (#1010) Aug 1, 2018
.gitmodules Remove internal git submodules (#9) Feb 24, 2017
.travis.yml Start cadence client worker upon worker role startup (#1244) Nov 14, 2018
CONTRIBUTING.md Adding up-for-grabs link (#1066) Aug 23, 2018
Gopkg.lock Update generated code to use latest thriftrw and update lock to be in… Oct 23, 2018
Gopkg.toml CLI: passing security token to server (#1190) Oct 18, 2018
LICENSE Readme (#10) Feb 24, 2017
Makefile sql: support for getTimerIndexTasks pagination (#1224) Nov 13, 2018
README.md Update README.md (#764) May 23, 2018
install-dep.sh Move from glide to dep (#1010) Aug 1, 2018

README.md

Cadence Build Status Coverage Status

Cadence is a distributed, scalable, durable, and highly available orchestration engine we developed at Uber Engineering to execute asynchronous long-running business logic in a scalable and resilient way.

Business logic is modeled as workflows and activities. Workflows are the implementation of coordination logic. Its sole purpose is to orchestrate activity executions. Activities are the implementation of a particular task in the business logic. The workflow and activity implementation are hosted and executed in worker processes. These workers long-poll the Cadence server for tasks, execute the tasks by invoking either a workflow or activity implementation, and return the results of the task back to the Cadence server. Furthermore, the workers can be implemented as completely stateless services which in turn allows for unlimited horizontal scaling.

The Cadence server brokers and persists tasks and events generated during workflow execution, which provides certain scalability and realiability guarantees for workflow executions. An individual activity execution is not fault tolerant as it can fail for various reasons. But the workflow that defines in which order and how (location, input parameters, timeouts, etc.) activities are executed is guaranteed to continue execution under various failure conditions.

This repo contains the source code of the Cadence server. To implement workflows, activities and worker use Go client or Java client.

See Maxim's talk at Data@Scale Conference for an architectural overview of Cadence.

Getting Started

Start the cadence-server locally

  • Build the required binaries following the instructions here.

  • Install and run cassandra locally:

# for OS X
brew install cassandra

# start cassandra
/usr/local/bin/cassandra
  • Setup the cassandra schema:
make install-schema
  • Start the service:
./cadence-server start

Using Docker

You can also build and run the service using Docker.

Run the Samples

Try out the sample recipes here to get started.

Use CLI

Try out Cadence command-line tool to perform various tasks on Cadence

Contributing

We'd love your help in making Cadence great. Please review our instructions.

License

MIT License, please see LICENSE for details.