Menu
Chef Automate on AWS
Chef Automate Quick Start

Step 3. Launch the Chef Stack

This automated AWS CloudFormation template deploys Chef Automate into a new VPC. Please make sure that you have completed the previous step and have subscribed to the Chef Automate AMI in AWS Marketplace before launching the stack.

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

    
                                                    Chef Automate Quick Start launch button

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

    This stack takes approximately 35 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 in this Quick Start for full details.

    You can also download the template to use it as a starting point for your own implementation.

  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 values for the required parameters. For all other parameters, the template provides default settings that you can customize.

    Network Configuration:

    Parameter label Parameter name Default Description
    Availability Zones AvailabilityZones Requires input The list of Availability Zones to use for the subnets in the VPC. The Quick Start uses two Availability Zones from your list and preserves the logical order you specify.
    Public Subnet CIDR PublicSubnetCIDR 10.0.128.0/20 CIDR block for the private subnet.
    Remote Admin CIDR RemoteAdminCIDR Requires input CIDR block or IP for SSH and RDP access to the Chef Automate software. We recommend that you set this value to a trusted IP range. For example, you might want to grant only your corporate network access to the software.
    VPC CIDR VPCCIDR 10.0.0.0/16 CIDR block for the VPC.

    Chef Automate Configuration:

    Parameter label Parameter name Default Description
    Administrator Password AdminPassword Requires input Password for the "chefadmin" user for signing in to the Chef workstation and Management Console. This must be a complex password that’s at least 8 characters long.
    Chef Automate Instance Type ChefAutomateInstanceType t2.xlarge EC2 instance type for master Chef Automate instances.
    Chef Nodes ChefNodes 1 The number of nodes you want to support. The Chef Automate AMI allows you to manage up to 10 nodes for free.
    Enable and Launch Demo Instances IncludeDemoInstances true Keep the default value to include a Chef workstation and demo node. To deploy Chef Automate only, set this parameter to false.
    Key Pair Name KeyPairName Requires input Public/private key pair, which allows 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.

    AWS Quick Start Configuration:

    Parameter label Parameter name Default Description
    Quick Start S3 Bucket Name QSS3BucketName aws-quickstart The S3 bucket you have 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 quickstart-chef-automate/ 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.
  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.

  6. Choose Create to deploy the stack.

  7. Monitor the status of the stack. When the status displays CREATE_COMPLETE, Chef Automate is ready.