A source repository is maintained as a demo for the Rattail deployment framework. Its goals are to:
- Illustrate some of the key concepts of the framework.
- Provide a convenient way to try out an actual working example.
- Provide a starting point for creating new server bundle projects.
You must first set up your control environment. Assuming Python/pip/virtualenv are present, create (and activate) a new virtual environment:
cd /srv/envs virtualenv fabdemo source fabdemo/bin/activate
Fetch the demo code with:
cd ~/src git clone https://rattailproject.org/git/rattail-fabdemo.git
With your virtual environment activated then, install the package:
cd ~/src/rattail-fabdemo pip install -e .
Server Bundle Prep
See Server Bundle Prep for general instructions, but in the case of the demo, there is technically none required at all. This is a convenience; bundles normally always require some prep.
Server Machine Prep
As with any bundle, you have two main (documented) options for the target server. You can either target a conventional (physical) machine, in which case see Server Machine Prep, or you can target a virtual machine, in which case see Testing with Vagrant.
Bootstrapping the Server
With your virtual environment activated, bootstrap the 'host' server with (paraphrasing here, fab options will depend on your connection needs):
cd ~/src/rattail-fabdemo/servers/host fab -H target bootstrap_all