This repository contains definitions and files necessary for recreating vagrant boxes suitable for running module tests with.

You can access to the produced vagrant boxes here:

http://puppet-vagrant-boxes.puppetlabs.com

The primary goal is to create boxes that have very little specialisation at this level, the standard veewee templates should be very rarely modified to keep it simple, and even then bug fix should always be feed back to upstream (ie. VeeWee). This holds for any bugs we find in the templates, and any new templates that are required. In short our goal here is not to fork VeeWee templates, but to provide a snapshot of the template at box build/publish time.

Environment setup

You'll need Ruby 1.9.3 and Bundler before you begin. You should also install a copy of Vagrant from the instructions provided here:

http://downloads.vagrantup.com/

Once you have vagrant installed, start by entering the directory where you have cloned this project:

$ cd <path to repo>

Optional Create an RVM gemset:

$ rvm --create --ruby-version use ruby-1.9.3@puppet-vagrant-boxes

Then install the bundle:

$ bundle install

Adding a new definition

Note: Change the base command between vbox or fusion depending on your target provider.

Get a list of available definitions:

$ veewee [vbox|fusion] templates

Pick one, and define it using:

$ veewee [vbox|fusion] vbox define '<box_name>' '<template_name>'

Make sure <box_name> follows the convention:

<osdistro>-<derivative>-<version>-<arch>-<virtual-type>-<variant>

• osdistro: for example: centos, ubuntu, windows
• derivative: (optiona) server, desktop
• version: 8, 2008, 1104
• arch: x64, i386
• virtual-type: type & version. For example: vbox4210, fusion503
• variant (optional):
  • nocm: designates no configuration management tools were loaded

Examples:

ubuntu-server-1104-x64-vbox410
centos-58-i386-vbox410
windows-2008r2-x64-vbox410
debian-607-x64-vbox410-nocm
centos-64-x64-fusion503

Naming caveats:

• The name becomes the hostname of the box ... so you have to be careful.
• Debian/Ubuntu doesn't like underscores in the name.
• A dot in the box name would create a subdomain, which is probably not desirable.

Once you've produced a new box you should modify html/index.html to add it so it can be accessed from the index on S3.

Finally, follow the next steps for building a box.

Building a box

Pick a box to build:

$ veewee [vbox|fusion] list

To build it:

$ veewee [vbox|fusion] build <box-name>

At this point it will download necessary ISO's and start building a box.

Now validate the box:

$ veewee [vbox|fusion] validate <box-name>

And export the vm to a .box file:

$ veewee [vbox|fusion] export 'centos-58-x64'

Publishing

Now upload the box located in the current directory (ie. centos-58-x86_64.box) to the S3 bucket puppet-vagrant-boxes, and if you modified the index.html, upload that as well.

If the image is new, or you changed the name, also update the site http://vagrantbox.es/, you do this by raising a PR on the repository below:

http://github.com/garethr/vagrantboxes-heroku