orderly is a tool that provides ordered and controlled start, stop, restart and cleanup of a group of processes. It aims to be a building block for reliable servers/services/containers/dev-environments.
orderly draws inspiration from erlang supervisor trees, It provides mechanisms to build a tree of supervised processes, and failure can propagrate when process restarts rate exceeds a specified limit.
orderly does actions via external hooks written in any programming language you prefer. orderly does not make assumptions about your application or the setup/teardown that must be done to run it correctly and reliably.
If this interests you, you can read the manual here.
orderly was originally made to support reliable recovery of inter-dependant services after failure on a runit based linux system. In this configuration orderly runs beneath runit, providing grouping, left to right start and right to left cleanup that runit lacks. This allows for things like crashed fuse file systems to be cleanly unmounted and recreated, where the unordered restarts of runit cause problems.
orderly also addresses some quality of life problems when developing a group of servers. Generally when developing 'microservice' style projects you are stopping and starting many processes that depend on eachother. orderly makes this work easier, as a single terminal window + ctrl+c is all that is needed to reliably kill/restart all your services.
More complicated init systems like systemd support some of this functionality, but not for these use cases, and only for systems that go 'all-in' with systemd. The project author is a fan of the openbsd operating system for example, which does not even support systemd.
$ orderly -max-start-tokens 2 -start-tokens-per-second 0.1 -- \ -name redis -run ./run-redis -wait-started ./wait-redis -- \ -name website -run ./run-website -check ./health-check-website -cleanup ./website-cleanup
For a full featured example with code, check the example directory.
The software works, but the interface is not stable and still being tweaked. Expect breaking changes between releases until version 1.0.0 is released.
Building from source
Orderly is a rust project, so running
cargo build is sufficient for
most people after cloning the git repository.
Binary packages are not yet provided.
The program can be installed from cargo with
cargo install orderly
Try the mailing list
Or create a github issue
This project was sponsored by backupbox.io
This project took time and effort to make, please sponsor the project via this paypal donation link.
Add a markdown message shorter than 70 characters total to your donation it will be added to the sponsor section. Note that sponsor messages may be rejected at the project authors judgement.