Repository files navigation

Website:http://dkron.io/

Dkron is a distributed cron service, easy to setup and fault tolerant with focus in:

• Easy: Easy to use with a great UI
• Reliable: Completely fault tolerant
• Highly scalable: Able to handle high volumes of scheduled jobs and thousands of nodes

Dkron is written in Go and leverage the power of the Raft protocol and Serf for providing fault tolerance, reliabilityand scalability while keeping simple and easily installable.

Dkron is inspired by the googlewhitepaperReliable Cron across the Planet and by Airbnb Chronosborrowing the same features from it.

Dkron runs on Linux, OSX and Windows. It can be used to run scheduled commands on a server cluster using any combinationof servers for each job. It has no single points of failure due to the use of the Gossip protocol and fault tolerantdistributed databases.

You can use Dkron to run the most important part of your company, scheduled jobs.

Installation instructions

Full, comprehensive documentation is accessible on theDkron website

The best way to test and develop dkron is using docker, you will needDocker with Dockercompose installed before proceeding.

docker compose up -d

The UI should be available onhttp://localhost:8080/ui.

To add jobs to the system read theAPI docs.

To add more Dkron instances to the cluster:

docker compose up -d --scale dkron-server=4docker compose up -d --scale dkron-agent=10

To develop Dkron, you can deploy the cluster with local changes applied with the following steps:

1. Clone the repository.

2. Run thedocker compose:

   docker compose -f docker-compose.dev.yml up

Dkron dashboard is built usingReact Admin as a single page application.

To start developing the dashboard enter theui directory and runnpm install to get the frontend dependencies andthen start the local server withnpm start it should start a new local web server and open a new browser windowserving de web ui.

Make your changes to the code, then runmake ui to generate assets files. This is a method of embedding resources inGo applications.

Chef cookbookhttps://supermarket.chef.io/cookbooks/dkron

Python Client Libraryhttps://github.com/oldmantaiter/pydkron

Ruby clienthttps://github.com/jobandtalent/dkron-rb

PHP clienthttps://github.com/gromo/dkron-php-adapter

Terraform providerhttps://github.com/bozerkins/terraform-provider-dkron

Manage and run jobs in Dkron from your django projecthttps://github.com/surface-security/django-dkron

Made withcontrib.rocks.

• Twitter:@distribworks
• Chat:https://gitter.im/distribworks/dkron
• Email: victor at distrib.works