Thank you for choosing Puppet Enterprise (PE). System administrators use PE to programmatically provision, configure, and manage servers, network devices, and storage, whether in a data center or in the cloud.
This guide covers how to install, configure, and use the Puppet Enterprise Azure Marketplace template for Azure Resource Manager (ARM).
For additional information about Puppet Enterprise, see these pages in the PE documentation:
Overview
This Puppet Enterprise Azure Marketplace Image contains a monolithic installation of PE, comprised of a collection of PE services running on a single Azure VM—the Puppet master. The PE Architecture Overview describes PE's major services and components.
After you launch the VM with the ARM template, PE is automatically and securely configured during operating system boot. Unique keys and certificates are generated, PE services are started, and the local node is brought under PE management.
Next, install Puppet agent on systems that will be managed by the master. Agent packages are included for all supported platforms, including *nix distributions, Windows, and macOS, so you can quickly deploy and provision a PE-managed virtual network.
- Configuring Azure
Before installing PE, select an appropriate Azure machine type and configure a security group to accommodate PE's required network ports. - Launching the ARM template
The Puppet Enterprise ARM starting template launches the Puppet Enterprise Azure Image. - Connecting agents
To connect agents to the master, this image is configured to use a private virtual network. - Certificates and DNS configuration
Using the master's private VM hostname, PE generates certificates which include the master's public fully qualified domain name andpuppetas alternate DNS names. - Tuning and configuration
The PE installation contained in this image is pre-configured and tuned for use with up to 4,000 nodes. - Running commands on nodes
When running these Puppet commands on nodes in Azure environments, you must first switch to the superuser role by runningsudo su. - Migrating to a larger instance type
As your PE-managed infrastructure grows, moving to a larger Azure VM size improves your system performance. - Upgrading
There is no automated process for upgrading to newer versions of the PE Azure ARM Image. As with any PE installation, however, you can manually upgrade PE to the latest release from the Puppet master's command line. - Troubleshooting
When using the Puppet Enterprise Azure Marketplace Image and ARM template, you might encounter some problems that this troubleshooting section can address.