Blog

November 21, 2021

How to Integrate Puppet Enterprise with VMware Cloud Assembly

by Dimitri de Swart

How to & Use Cases,

Ecosystems & Integrations

In this post, I will walk you through how to integrate Puppet Enterprise with VMware Cloud Assembly and use it in your blueprint so that you can manage deployments for configuration and drift. In this example I'll be using a vSphere blueprint which I created in a previous post and saved by creating a version.

Table of Contents

  1. What is VMware Cloud Assembly?
  2. Set Up Your Puppet Enterprise + VMware Cloud Assembly Integration
Back to top

What is VMware Cloud Assembly?

VMware Cloud Assembly provides an abstraction layer across multiple clouds using a Cloud API which makes it possible to create declarative templating constructs, which VMware calls Blueprints.

Blueprints can deploy cloud agnostic resources (compute, storage, network etc.) across clouds. As of this writing, Cloud Assembly supports Amazon AWS, Microsoft Azure, VMware Cloud on AWS and vSphere (with or without NSX-V/T), and others will soon be added.

Back to top

Set Up Your Puppet Enterprise + VMware Cloud Assembly Integration

To integrate Puppet-based VM configuration management, you must have a valid instance of Puppet Enterprise installed on public cloud or private cloud with a vSphere workload. In the public cloud, Cloud Assembly supports Puppet Enterprise instances on Azure/AWS. You can find more information in Puppet docs on setting up Puppet Enterprise with a basic configuration and some Starter Content.

You must establish a connection between this external system and your Cloud Assembly instance. Then you can make Puppet configuration management available to Cloud Assembly by adding it to appropriate blueprints.

  1. Login to Cloud Assembly, and select Integrations under the Infrastructure tab. Click Add Integration.
  2. Select Puppet.
A screenshot of the Integrations page of the VMWare console displaying the Puppet integration.
  1. Enter your Puppet Enterprise server FQDN and Autosign secret.
  2. Select your Puppet Enterprise server location. In my case, Private Cloud.
  3. Select your Data Collector and enter your Puppet server credentials. Enable Sudo depending on the user you entered. Click Validate.
  4. Enter a Name for the integration. Optionally, enter a Description. Click Add.

Add Puppet to Your Blueprint

The blueprint Puppet provider component installs, configures, and runs the Puppet agent on a deployed compute resource. The Puppet provider supports both ssh and WinRM connections. When machines are deployed, users can add or delete a Puppet server as an external system or update projects assigned to the Puppet server. Finally, appropriate users can de-register deployed machines from the Puppet server when the machines are decommissioned.

  1. Click on the Blueprints tab and select your previous vSphere blueprint.
A screenshot of the Blueprints page of the VMWare console displaying the Puppet integration.
  1. In the left menu, scroll down or search for the Puppet component. Select it and drag it to the canvas.
A screenshot of the Blueprints page of the VMWare console displaying the Puppet integration in the VMguru-vSphere-blueprint blueprint.
  1. In the YAML editor, click on + to view all available code properties for the Puppet component.
A screenshot of YAML code in the VMWare console displaying code properties of the Puppet component.
  1. Click on the host property to view what it means and what's expected.
A screenshot of the Host property in the YAML code properties of the Puppet component in the VMWare console.
  1. Enter ${Cloud_vSphere_Machine_1.*} as value for the host property. A dependency (arrow) will automatically be drawn to the vSphere machine in the canvas.
A screenshot of the Blueprints page of the VMWare console displaying a new dependency drawn between the Puppet component and a vSphere machine.
  1. Next, enter the Puppet role and environment under properties. But to know which roles are available in which environment, login to your Puppet Enterprise console, select Classification and expand Roles. In my case I'll be using the Wordpress role available in the Dev environment.
A screenshot of the Roles section of the Classification page of the Puppet Enterprise console displaying available roles.
  1. Enter the provider, the Puppet integration name you entered in the previous steps.
  2. And finally, enter the osType (linux or windows) and user credentials for installing the Puppet agent. Optionally, change useSudo to true if you’re not using root.

Version and Deploy Your Blueprint

  1. In the blueprint canvas, click Version.
  2. Enter the Version number and optionally a Description and Change Log. Click Create.
A screenshot of the Create Version interface in the Blueprints page of the VMWare console with a description and change log of the action taken to integrate Puppet.
  1. In the blueprint canvas, click Deploy.
  2. Select Create a new deployment and enter a Deployment name. Select the Blueprint version you just created and click Deploy.
A screenshot of the Deploy screen page of the Blueprints page in the VMware console as the user prepares for deployment of the blueprint with Puppet.
  1. Click on the Deployments tab to see the progress of your deployment.
A screenshot of the Deployment screen on the Blueprints page of the VMWare console displaying the deployment of a VM in progress (50% completion).
  1. If successful, the deployed resources will be shown.
A screenshot of the Deploy screen of the Blueprints page of the VMWare console displaying a successful deployment.
  1. Login to vCenter Server to verify the VM is available and running.
A screenshot of the vCenter Server console confirming a VM has been successfully deployed.
  1. Then, login to the Puppet Enterprise console, to verify the VM has a Puppet agent, is added as node and has software deployed to it. In the console, select Overview or Nodes.
A screenshot of the Overview page of the Puppet Enterprise console displaying a VMware VM with the Puppet agent installed.
  1. Click on the new node to view its Facts. Notice that Cloud Assembly properties of the VM are passed to Puppet as Facts.
A screenshot of the Nodes page of the Puppet Enterprise console displaying Facts associated with the newly deployed VM.
  1. Select the Reports tab to see what Puppet has done to bring the VM in the desired state. For example, install packages.
A screenshot of the Reports screen in the Puppet Enterprise console displaying actions Puppet has taken to enforce desired state in the VMware VM.
  1. Open a web browser, enter http:// to verify Wordpress is installed.
A screenshot of a browser window confirming Wordpress has been installed on the newly deployed VMware VM.

Et voila, Configuration Management integration made easy with VMware Cloud Assembly and Puppet Enterprise. Happy coding!

Ready to get started with Puppet Enterprise and make configuration management easier than ever?

START MY TRIAL 

Learn More

This blog was originally published on November 21, 2018 and has since been updated for accuracy and relevance.

Back to top