AWS CloudFormation
User Guide (API Version 2010-05-15)
Did this page help you?  Yes | No |  Tell us about it...
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.

Selecting a Stack Template on the AWS CloudFormation Console

After starting the Create Stack wizard, you specify a stack name and select the template that you want AWS CloudFormation to use to create your stack.

AWS CloudFormation templates are JSON files that specify the AWS resources that make up your stack. For more information about AWS CloudFormation templates, see Template Anatomy.

To choose a stack name and select a stack template:

  1. On the Create A New Stack page of the Create Stack wizard, type a stack name in the Name box.

    A stack name can contain only alphanumeric characters (case sensitive) and hyphens. It must start with an alphabetic character and cannot be longer than 255 characters.

  2. Choose a stack by using one of the following options:

    Select a sample template

    Select an AWS CloudFormation sample template from the menu. For descriptions of the templates, see Sample Templates.

    To create a stack from existing AWS resources by using the CloudFormer tool, select CloudFormer from the list. For more information, see Using CloudFormer to Create Templates.

    Upload a template to Amazon S3

    Select an AWS CloudFormation template on your local computer. Specify the full path, or choose Browse to select the template file that you want to upload.

    An uploaded template can be, at most, 51200 bytes.

    Note

    If you upload a local template file, AWS CloudFormation uploads it to an Amazon Simple Storage Service (Amazon S3) bucket in your AWS account. The buckets are accessible to anyone with Amazon S3 permissions in your AWS account. If you don't already have an S3 bucket that was created by AWS CloudFormation, it creates a unique bucket for each region in which you upload a template file. If you already have an S3 bucket that was created by AWS CloudFormation in your AWS account, AWS CloudFormation adds the template to that bucket.

    You can use your own bucket and manage its permissions by manually uploading templates to Amazon S3. When you create or update a stack, specify the Amazon S3 URL of a template file.

    Specify an Amazon S3 template URL

    Specify a URL to a template in an Amazon S3 bucket.

    If you have a template in a versioning-enabled bucket, you can specify a specific version of the template, such as https://s3.amazonaws.com/templates/myTemplate.template?versionId=123ab1cdeKdOW5IH4GAcYbEngcpTJTDW. For more information, see Managing Objects in a Versioning-Enabled Bucket in the Amazon Simple Storage Service Console User Guide.

    The URL must point to a template (max size: 460,800 bytes) in an Amazon S3 bucket that you have read permissions to, located in the same region as the stack. The URL itself can be, at most, 1024 characters long.

  3. Click Next Step to accept your settings and proceed with specifying stack parameters.