stianwestvig / react-template

React with browserify and live reload webserver

Vagrant development box

This box is a starting point for new projects. This box has been tested on OSX, it should work on Linux and it might work on Windows.

Prerequisites

These are things you need to install once on your machine to use this box.

• Virtualbox
• Vagrant
• Python, to run the new project setup script.

Then run:

vagrant plugin install vagrant-vbguest

Starting a new project

To start a new project run:

python setup.py --directory <project-directory> [--remote <new repo url>]

Only one project member needs to do this.

If you have personal configuration needs or tools you need installed that are not used by the project. e.g: custom dotfiles. Create a ~/.vagrant.d/Vagrantfile and call provisioning to install your config/tools.

Your project might need to expose servers to the host OS (so that you can open websites in a brower etc). To forward a port open the ./Vagrantfile a line like this:

config.vm.network :forwarded_port, guest: <port nr>, host: <port nr>

Each project menber can now clone the new repo

git clone <repo url>

Starting the box

vagrant up
vagrant ssh
cd /vagrant

This will place you inside the directory shared with the host OS.

Stopping the box

vagrant halt

This will shutdown the virtual machine.

Software

SaltStack is used to install software to change what is installed have a look at the documentation. For a quicker provisioning process you should remove software that you do not need in your project.

The main file to include or exclude software is ./salt/roots/salt/top.sls.

After adding new software to the saltstack configuration run:

vagrant provision