Legion


License
Apache-2.0
Install
pip install legion==0.11.0

Documentation

Legion - Free & Scalable PAAS

Toolkit to load-balance an app on Heroku free plan.

How to use?

Your app must not be on Heroku yet. If it is, remove all remotes pointing to Heroku.

Create a new legion:

legion create [--region REGION]

This will create an app named [app-name] on your Heroku app dashboard.

Provision your legion

Recruit new legionaries on your legion with:

legion scale 20 [argument-for-all-heroku-app]

This will create 20 new apps, named [app-name]-legion-[number]

Deploy

Deploy your source code on all your dynos

legion deploy

Destroy

Warning: this will destroy all apps from this legion!

legion destroy

How does it works?

To make a legion with n dynos, legion creates n+1 apps on heroku; your n workers and a load-balancer. The load-balancer is a simple round-robin between all your nodes.