This is an attempt to concisely define and document the server configuration and deployment for Hackasaurus sites using a combination of Python scripts and Puppet Best Practices.
The sites this repository is capable of configuring and deploying include:
- webpad.hackasaurus.org - An experimental fork of jsbin.
- hackasaurus.org - Primary Hackasaurus website.
- hackbook.hackasaurus.org - The Hackbook, an experimental HTML and CSS reference.
- htmlpad.org - HTMLPad, a simple experimental app that allows people to use Etherpad to write and collaborate on HTML, CSS, and JavaScript.
- hackpub.hackasaurus.org - hackpub, a simple REST API allowing the X-Ray Goggles to publish shared hacks as static files to Amazon S3.
- swarm.hksr.us - An experimental Test Swarm instance for the Web X-Ray Goggles.
- webxray.hackasaurus.org - The latest official production release of the Web X-Ray Goggles.
Deployment is assumed to target a bare Ubuntu natty server (11.04). All other dependencies are automatically installed by the various configuration files in this repository.
You'll need Fabric.
First, clone the repository and check out its submodules:
git clone git://github.com/hackasaurus/hackasaurus-puppet-data.git
cd hackasaurus-puppet-data
git submodule update --init
To deploy Hackasaurus applications to a remote server, run:
fab -u root -H yourserver.org deploy
To run integration tests on a remote server, run:
fab -H yourserver.org test
Run fab -l for more commands, and fab -d <command> for detailed help
on a particular command.
Default passwords and other secrets for Hackasaurus applications are stored
in secrets.json. You can override specific values by creating
secrets.hostname.json, where hostname is your server's hostname.
Virtual hosting configurations are used for the domains of Hackasaurus sites. To make development and testing easy, each site can also be accessed at its normal domain suffixed with .dev.
For example, if you want to access htmlpad.org on your development server, you can add an entry for htmlpad.org.dev to your /etc/hosts file.