Home

VagrantSpec Tutorial

Introduction

VagrantSpec is a vagrant plugin that allows you to run system tests on a Vagrant node set after the build, configuration, and orchestration phases. The build phase is the instantiation of the node set. The configuration phase is the application of configuration management to your system. The orchestration phase is systematic application of coordinated events to converge into a ready state. After all is said and done, it is a wise choice to validate that the system is functioning as desired. This is where vagrant_spec comes in.

What You'll Need

To get started, you'll need to download Vagrant and Virtualbox. Vagrant is the virtual machine manager that uses Ruby to configure local and remote node sets for development and testing. If this is new to you, please take a look at the vagrant tutorial. VirtualBox is the default virtual machine hypervisor for Vagrant. It is free and open source, so Vagrant will use it under the hood.

A basic understand of Ruby syntax will be helpful in this tutorial. While a full command of the language is not required, Vagrant's configuration in the Vagrantfile is pure Ruby. If you're completely new to ruby or programming in general, take a look at Code Academy to get a handle on the basics. The tutorial is very friendly for beginners and will help make sense of all the strange do syntax.

Lastly, the vagrant_spec officially supports OSX and Linux workstations at this time. While the plugin may work fine on Windows, it has not been tested on this platform so results may vary.

Now that we have all of that out of the way, let's jump right in.

The App

TODO

The Web Server

TODO

The Task File

TODO

The Tests

TODO

Run it!

TODO