sugar-dev-box

NOTE: This project is discontinued and has been archived.
I recommend using Docker Compose with the main Sugar repository instead

Requirements

First, build the virtual machine. This might take a few minutes:

host $ git clone https://github.com/elektronaut/sugar-dev-box.git
host $ cd sugar-dev-box
host $ vagrant up

Clone your Sugar fork into the same directory:

host $ git clone git@github.com:<username>/sugar.git

Vagrant mounts this directory as /vagrant within the virtual machine. Log in with:

host $ vagrant ssh
Welcome to Ubuntu 12.04 LTS (GNU/Linux 3.2.0-23-generic-pae i686)
...
vagrant@sugar-dev-box:~$

On the VM, run Bundler to install the rest of the dependencies, create the configuration and populate the database with:

vm $ cd /vagrant/sugar
vm $ bundle
vm $ bin/rake db:create
vm $ bin/rake db:migrate

To run the tests, you also need to create the test database:

vm $ bin/rake db:create RAILS_ENV=test
vm $ bin/rake db:migrate RAILS_ENV=test

host $ vagrant ssh
vm $ cd /vagrant/sugar
vm $ bin/rake sunspot:solr:start
vm $ bin/rails server -b 0.0.0.0

The development server is now accessible on localhost:3000.

host $ vagrant ssh
vm $ cd /vagrant/sugar
vm $ bin/rspec

The recommended workflow is

This workflow is convenient because in the host computer you normally have your editor of choice fine-tuned, Git configured, and SSH keys in place.

When done just log out with ^D and suspend the virtual machine

host $ vagrant suspend

then, resume to hack again

host $ vagrant resume

Run

host $ vagrant halt

to shutdown the virtual machine, and

host $ vagrant up

to boot it again.

You can find out the state of a virtual machine anytime by invoking

host $ vagrant status

Finally, to completely wipe the virtual machine from the disk destroying all its contents:

host $ vagrant destroy # DANGER: all is gone

Please check the Vagrant documentation for more information on Vagrant.

Based on rails-dev-box by Xavier Noria