Vagrant Examples

What is Vagrant?

Vagrant is a tool that uses Oracle's VirtualBox to dynamically build configurable, lightweight, and portable virtual machines. Vagrant supports the use of either Puppet or Chef for managing the configuration. Much more information is available on the Vagrant web site.

What is this project?

This is a collection of sample Vagrant configurations using Puppet. They start out very simple with the bare minimum and gradually get more complex. The examples use Ubuntu 12.04, though they should work with any Debian-based Linux distribution. Other distros such as Fedora and SUSE could be supported with some Facter logic in the manifests to ensure that platform-specific packages are installed correctly (e.g. httpd vs apache2).

How do I install Vagrant?

The host OS used in testing these examples was Mint 14 (Ubuntu-based), but any OS should work as long as VirtualBox can be installed. The Vagrant version used in these examples is v1.1.0. The Vagrant download page lists several options for installing v1.1.0.

How do I run the examples?

From one of the example directories, type the following commands...

vagrant box add precise32 http://files.vagrantup.com/precise32.box
vagrant up
vagrant ssh
vagrant destroy

These commands will bring up the Vagrant box, SSH into it, and then remove it respectively.

Summary of examples