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 Amazon Web Services (AWS) Marketplace Image.
Overview
This AWS Marketplace Image (AMI) contains a monolithic installation of PE, comprised of a collection of PE services running on a single EC2 instance—the Puppet master. The PE Architecture Overview describes PE's major services and components.
After you launch the image in EC2, 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 Mac OS X, soyou can deploy and provision a PE managed Virtual Private Cloud (VPC).
- Supported Puppet Enterprise version
Puppet offers pay-as-you-go (PAYG) and bring-your-own-license (BYOL) versions of PE as Amazon Machine Images (AMI). - Configuring AWS
You must run PE on an approprate EC2 instance, and manage nodes within a securely configured EC2 VPC to accomodate PE's required network ports. - Launching the image
Launching the image ensures the Puppet master is ready to manage nodes, and for agents to connect with it. - Connecting agents
To connect agents to the master, this image is configured to use private (internal) EC2 hostnames. - Certificates and DNS configuration
Using the master's private EC2 hostname, PE generates certificates which include the master's public EC2 hostname andpuppet
as 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. - Migrating to a larger instance type
As your PE-managed infrastructure grows, moving to a larger AWS instance type improves your system performance. - Upgrading Puppet Enterprise
There is no automated process for upgrading to newer versions of the PE AMI. 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 Marketplace Image, you might encounter some problems that this troubleshooting section can address. - Support
You can get help with Puppet from us and the rest of the Puppet community. If you've purchased Puppet Enterprise, you can also access our knowledge base and open a support ticket. - Example EC2 security group policy
This JSON structure is an example EC2 security group policy that accommodates inbound network ports required by Puppet.