This document discusses using Oscar, which is a set of Vagrant plugins and templates, to develop and test Puppet code locally using a virtualized environment. Oscar builds a full Puppet Enterprise environment on top of Vagrant and allows configuring virtual machines, setting up a master node and agent nodes, and testing Puppet code using tools like RSpec. The document provides details on Oscar commands, file configuration, customizing Oscar for specific needs, and links to documentation and examples for further reference.

1. Developing and Testing
with “Enhanced” Oscar
Jeff Scelza
jeffrey.scelza@twcable.com
Twitter: @theFunkyPuma

2. ● Almost 20 years in IT
● Currently work at TWC doing DevOps work
● Lover of Technology and Knowledge
About me

3. ● Checkout various modules locally
● Make changes, commit, and push to repository
● Git Hooks push to Jenkins
● Jenkins automatically Kicks off a CI process and pushes
to our masters
● Agents then pick up the changes
http://www.slideshare.net/philzimmerman900/killer-r10k
Our Normal Process

4. Not the best for starting new development or
requiring major changes!
So, what to do while keeping inline with tools
and process already being used.
Amazing process but...

5. Enter local system development
R10KRSpec-Puppet

6. VirtualBox is a general-purpose full virtualizer
for x86 hardware, targeted at server, desktop
and embedded use.
VirtualBox

7. Wikipedia says:
Vagrant is computer software for creating and configuring virtual
development environments.[2]
It can be seen as a wrapper around
virtualization software such as VirtualBox, KVM, VMware and around
configuration management software such as Ansible, Chef, Salt orPuppet.
What is Vagrant?

8. ● Is a set of Vagrant plugins and templates that build up a full Puppet
Enterprise environment based on top of Vagrant create by Adrian Thebo
● What makes up Oscar?
○ auto_network: configure private network interfaces
○ config_builder: Yaml based configuration for Vagrant
○ hosts: Manages guest DNS resolution w/ auto_network
○ pe_build: Manages rapid setup Puppet Enterprise
And Oscar?

9. ● Generate a working environment from template
vagrant oscar init
● Initialize current working directory with a sub
Vagrantfile that loads Oscar and generate generic
configs
vagrant oscar init-vms
Oscar: commands

10. ● What do the files look like?
● What cool thing can we do?
● How do can I code locally and use a
master/slave configuration?

11. Oscar file Break out

12. Vagrantfile

13. box.yaml

14. roles.yaml

15. pe_buid.yaml

16. vm.yaml

17. ● Customization of files/dirs:
Making Oscar “Enhanced”

18. puppet.conf.master

19. puppet.conf.agent

20. But what about the modules?

21. Setting up the Master and Agent(s)

22. Using rake to manage classes

23. Initial Puppet agent run

24. Using Rspec to valid the Catalog

25. Troubleshooting with DOT files

26. ● ServerSpec
Serverspec tests your servers' actual state by executing command locally, via SSH, via WinRM,
via Docker API and so on. So you don't need to install any agent softwares on your servers and can
use any configuration management tools, Puppet, Chef, CFEngine, Itamae and so on.
● Beaker
Beaker is an acceptance testing harness for Puppet PE and
other Puppet Projects. It can also be used as a virtual machine
provisioner - setting up machines, running any configuration on
those machines and then exiting.
Other tools to test with

27. ● cachier
○ limit the amount coffee you drink waiting on a VM to build
○ Caches gem, rpm, apt, and other Guest packages under ~/.
vagrant
● vagrant-vbguest
○ Installs/Updates the host’s VirtualBox Guest Additions on the
guest.
Other plugins I use:

28. ● https://github.com/adrienthebo/oscar
● https://www.virtualbox.org/
● https://www.vagrantup.com/
● Plug-ins
○ https://github.com/adrienthebo/vagrant-auto_network
○ https://github.com/adrienthebo/vagrant-hosts
○ https://github.com/adrienthebo/vagrant-config_builder
○ https://github.com/adrienthebo/vagrant-pe_build
○ https://github.com/fgrehm/vagrant-cachier
● Other Presentations and documents
○ http://www.slideshare.net/PuppetLabs/oscar-rapid-iteration-with-vagrant-and-puppet-enterprise
○ http://www.youtube.com/watch?v=1TgGQjjLDXg
○ http://fgrehm.viewdocs.io/vagrant-cachier
○ http://puppet-vagrant-boxes.puppetlabs.com/
● Test tools
○ http://serverspec.org/
○ http://rspec-puppet.com/
○ https://github.com/puppetlabs/beaker/wiki
● Github Example: https://github.com/jscelza/oscar_vagrant_example
Helpful Links and References: