autolab

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with autolab
   • What autolab affects
   • Setup requirements
   • Beginning with autolab
4. Usage - Configuration options and additional functionality
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Overview

This module configures and installs all the things required for a local test environment running on a Windows OS.

Module Description

Beginning with an install of Chocolatey, then Vagrant with any Vagrant Boxes specified & Oracle VirtualBox (VMware Workstation to be added soon). This module has been tested on Windows 8.1 with PE 3.8.1 & 4.2.1).

Setup

What autolab affects

Installation of the following components:

• Chocolatey
• Vagrant
• VirtualBox

Setup Requirements

Assuming this is a standalone developer workstation and not managed by puppet, a masterless puppet setup is used (Puppet PE 3.8.1) - however the module will work using a puppet master.

Ensure that the following modules are installed:

• puppetlabs-stdlib >= 1.0.0
• puppetlabs-powershell >= 1.0.4
• chocolatey-chocolatey >= 1.0.2
• badgerious-windows_env >= 2.2.1

Beginning with autolab

Testing:

An example init.pp can be found in the examples folder. Run puppet apply to test:

puppet apply "autolab/examples/init.pp" -v

Usage

class { 'autolab': }

To add more vagrant boxes:

class { 'autolab':
  vagrant_boxes => [ 'ubuntu/trusty64', 'puppetlabs/centos-6.6-64-puppet' ],
}

(NOTE: Consider the amount of time it takes for each vagrant box download, this will affect the puppet run [exec timeout is disabled to permit large downloads])

To specify a vagrant version & lab dir:

class { 'autolab':
  vagrant_boxes   => [ 'ubuntu/trusty64', 'puppetlabs/centos-6.6-64-puppet' ],
  vagrant_version => '1.7.4',
  vagrant_lab_dir => "c:\\vagrantlab",
}

Limitations

• Tested on Windows 8.1
• PE 3.8.1 & 4.2.1 (2015.2)

Development

Contributions welcome

Release Notes/Contributors/Etc

0.1.0

Initial commit

0.1.2

Updated docs

0.2.0

Added Oracle Virtualbox

0.2.1

Added version

0.2.2

Updated documentation

0.2.3

Included vagrant-reload plugin install, and fixes for defined resources in 4.2.1.