The Puppet Plug-in for vRealize Automation (vRA) provides tools and out-of-the-box components that easily create, provision, and manage application stacks on virtual servers.

This documentation walks you through setting up a reference implementation of the plug-in, vRO, and vRA, and isn't designed for out-of-the-box use in production. Once you've completed this guide, you should have a working environment and examples with which you can develop your own Puppet code, vRO workflows, and vRA blueprints.

Super quick start

Follow the Getting Started instructions included with the starter content if you're familiar with installing Puppet Enterprise and working with vRA/vRO, or if you just want to see a condensed plan for creating a reference implementation with vRA 7.3 Enterprise and Puppet Enterprise 2016.4 or newer.

You can find those instructions in this github project.

These docs assume vRA 7.3 Enterprise and building your own blueprints with the new Puppet component in the vRA GUI. You can still access the previous version of these docs for working with vRA 7.x and IaaS blueprints with custom Puppet properties and the two prebuilt blueprints which can be found on this branch of the starter content.

What the Puppet plug-in can do

With a single click, Puppet, vRealize Orchestrator (vRO), and vRA can automatically create a VM, install the Puppet agent, autosign its certificate, add Puppet roles and profiles, install the required Puppet modules and the software they configure, and set up the server for immediate use.

If you're new to Puppet and vRO, you can use vRO and vRA to set up a live, functional Puppet managed system with much less effort than building one manually.

If you're experienced with vRO, vRealize Automation (vRA), and Puppet, you can also use this plug-in to model common Puppet workflows as vRO workflows and vRA blueprints, then deploy them just as easily as other VMs while maintaining the advantages of a Puppet managed infrastructure.

If you are using vRealize Automation Enterprise 7.3 or higher, then adding Puppet management to blueprints is built into the vRA GUI. This plugin is still required for the integration to work. Once you have installed the plugin and  configured it with vRA 7.3  you can drag and drop Puppet management into blueprints.

Back to top