Oscar
Oscar is a set of Vagrant plugins and templates that build up a full Puppet Enterprise environment based on top of Vagrant.
Synopsis
Initialize the base Oscar environment:
└> vagrant oscar init
A stub Vagrantfile has been placed in this directory and default configurations
have been placed into the `config` directory. You can now run `vagrant up` to start
your Oscar built environment, courtesy of Vagrant.
Define a set of VMs:
└> vagrant oscar init-vms \
--master master=puppetlabs/centos-7.2-64-nocm \
--agent first=puppetlabs/centos-7.2-64-nocm \
--agent second=puppetlabs/ubuntu-14.04-64-nocm
Your environment has been initialized with the following configuration:
And build everything:
└> vagrant up
Bringing machine 'master' up with 'virtualbox' provider...
Bringing machine 'first' up with 'virtualbox' provider...
Bringing machine 'second' up with 'virtualbox' provider...
[... normal `vagrant up` goes here ...]
Commands
Oscar provides a set commands to generate a working environment from templates.
vagrant oscar init
This command initializes the current working directory with a stub Vagrantfile that loads Oscar, and generates generic configuration information for use with PE.
vagrant oscar init-vms
This command generates a set of guest machines inside of the vagrant environment.
Configuring
Oscar handles guest machine configuration with YAML.
The default configuration looks something like this:
config/roles.yaml
---
roles:
pe-puppet-master:
private_networks:
- {auto_network: true}
provider:
type: virtualbox
customize:
- [modifyvm, !ruby/sym id, '--memory', 1024]
provisioners:
- {type: hosts}
- {type: pe_bootstrap, role: !ruby/sym master}
[...]
config/pe_build.yaml
---
pe_build:
version: 3.0.0
config/vms.yaml
---
vms:
- name: master
box: centos-6-i386
roles:
- pe-puppet-master
- name: agent
box: debian-6-i386
roles:
- pe-puppet-agent
Oscar uses vagrant-config_builder to handle guest machine configuration.
Installation
$ vagrant plugin install oscar
Requirements
The plugins used in Oscar require the Vagrant 1.1 plugin API, so Vagrant 1.1+ is required.