Menu
Puppet on AWS
Quick Start Reference Deployment Guide

Step 2. Launch the Puppet Stack

This automated AWS CloudFormation template provided with this Quick Start deploys Puppet into a VPC. Please make sure that you’ve completed the previous steps before launching the stack.

  1. Launch the AWS CloudFormation template into your AWS account.

    
                                Puppet Quick Start launch button

    The template is launched in the US West (Oregon) Region by default. You can change the region by using the region selector in the navigation bar.

    This stack takes approximately 20 minutes to create.

    Note

    You are responsible for the cost of the AWS services used while running this Quick Start reference deployment. There is no additional cost for using this Quick Start. See the pricing pages for each AWS service you will be using for full details.

  2. On the Select Template page, keep the default URL for the AWS CloudFormation template, and then choose Next.

  3. On the Specify Details page, review the parameters for the template. These are described in the following table.

    Provide a value for the KeyPairName parameter. This parameter requires your input. For all other parameters, the template provides default settings that you can customize.

    Security Configuration:

    Parameter label Parameter name Default Description
    Select a key pair KeyPairName Requires input Public/private key pair, which enables you to connect securely to your instance after it launches. When you created an AWS account, this is the key pair you created in your preferred region.
    Source IP for remote access RemoteAdminCIDR Requires input CIDR block or IP address for SSH and RDP access (e.g., 1.1.1.1/32).

    AWS Quick Start Configuration:

    Parameter label Parameter name Default Description
    Quick Start S3 Bucket Name QSS3BucketName quickstart-reference S3 bucket where the Quick Start templates and scripts are installed. Use this parameter to specify the S3 bucket name you’ve created for your copy of Quick Start assets, if you decide to customize or extend the Quick Start for your own use. The bucket name can include numbers, lowercase letters, uppercase letters, and hyphens, but should not start or end with a hyphen.
    Quick Start S3 Key Prefix QSS3KeyPrefix puppet/latest/ The S3 key name prefix used to simulate a folder for your copy of Quick Start assets, if you decide to customize or extend the Quick Start for your own use. This prefix can include numbers, lowercase letters, uppercase letters, hyphens, and forward slashes.

    Network Configuration:

    Parameter label Parameter name Default Description
    CIDR range for your VPC VPCCIDR 10.0.0.0/16 CIDR block for the Amazon VPC.
    CIDR range for the subnet in your VPC SubnetCIDR 10.0.0.0/19 CIDR block for the subnet.
    IP address for the Puppet master PuppetMasterIP 10.0.0.10 IP address for the instance where the Puppet master is deployed.
    IP address for the Linux Puppet agent PuppetAgentLinuxIP 10.0.0.11 IP address for the instance where the Linux Puppet agent is deployed.
    IP address for the Windows Puppet agent PuppetAgentWindowsIP 10.0.0.12 IP address for the instance where the Windows Puppet agent is deployed.
  4. On the Options page, you can specify tags (key-value pairs) for resources in your stack and set additional options. When you're done, choose Next.

  5. On the Review page, review and confirm the template settings. Under Capabilities, select the check box to acknowledge that the template will create IAM resources.

  6. Choose Create to deploy the stack.

  7. Monitor the status of the stack. When the status displays CREATE_COMPLETE, the Puppet cluster is ready.