The idea is to provide a simple dev box with tools.

Sometimes you want to play with a project, which leads you to install a lot of stuff on your computer and the filesystem gets messy. Your computer turn out to be slow booting up, because it is loading a database that you never use. Maybe you want to try out a language but it requires you to install all the libraries and compilers.

Now you can mess up all the files in your dev box, and discard when you think it is to messy.

• Requirements
• Installation
• Commands
• Using GUI programs
• Extending with your own puppet scripts
• Debugging

• Vagrant
• Internet connection
• git

Make sure you have vagrant installed and configured on your machine.

git clone https://github.com/bltavares/baseline.git /opt/baseline
echo 'export PATH=$PATH:/opt/baseline/bin' >> $HOME/.bashrc
echo 'eval "$(baseline autocomplete)"' >> $HOME/.bashrc

baseline init <path to init box>

baseline up [<environments>]

• Arguments:
  • environments: optional list of enviroments to start the box with. If no argument is passed, it will come up with the last configuration used

e.g.:

baseline up ruby nodejs

baseline ssh

baseline provision <environments>

baseline down

baseline destroy

baseline update

Ssh allows you to forward the X server to your computer. If you want to use a program with a grafical interface or want to code an app that generates graphics, you can ask vagrant to forward it for you.

Just goes with:

baseline ssh -- -X

Sometimes you will want to try out some different modules that are not currently in the project, or will want to set up a webserver for the project you are writing and have it configured and deployed with your project. Or maybe you just want to have some packages installed, or removed.

You can achieve that extending the project using the .baseline/puppet/custom folder. There is an example file to guide you in the path to extend your vagrant machine.

When building puppet scripts, a verbose output can help. In those cases we provide the DEBUG variable to increase the output, show debug messages and create dependency graphs

DEBUG=1 baseline up redis