CI/CD Pipeline for AWS CloudFormation Templates on AWS Using TaskCat
CI/CD with TaskCat Quick Start

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Step 2. Launch the Quick Start

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. For full details, see the pricing pages for each AWS service you will be using in this Quick Start. Prices are subject to change.

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

    The deployment takes about 15 minutes to complete.

  2. Check the region that’s displayed in the upper-right corner of the navigation bar, and change it if necessary. This is where the CI/CD pipeline for AWS CloudFormation templates will be built. The template is launched in the US West (Oregon) Region by default.

  3. On the Select Template page, keep the default setting for the template URL, and then choose Next.

  4. On the Specify Details page, change the stack name if needed. Review the parameters for the template. Provide values for the parameters that require input. For all other parameters, review the default settings and customize them as necessary. When you finish reviewing and customizing the parameters, choose Next.

    In the following tables, parameters are listed and described by category.

    View template

    GitHub Configuration:

    Parameter label Parameter name Default Description
    Repository owner GitHubUser Requires input The GitHub user name of the repository owner.
    Repository name GitHubRepoName Requires input The name of the GitHub repository that CodePipeline should monitor for AWS CloudFormation template changes. This GitHub repository must be set up as described in the Prerequisites section.
    Source branch SourceRepoBranch Requires input The name of the source branch to be monitored in the GitHub repository. This branch has the AWS CloudFormation templates that are actively being developed. CodePipeline monitors this branch and initiates testing whenever it detects any changes to the templates.
    Release branch ReleaseBranch Requires input The name of the release branch in the GitHub repository. This is the branch that contains the stable code that has already been tested. After a successful build, the source branch is merged into the release branch.
    OAuth2 token GitHubOAuthToken Requires input The name of the GitHub token with repo and admin:repo_hook permissions, from step 2.

    AWS Quick Start Configuration:

    Parameter label Parameter name Default Description
    Quick Start S3 Bucket Name QSS3BucketName quickstart-reference 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-taskcat-ci/ 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.
  5. On the Options page, you can specify tags (key-value pairs) for resources in your stack and set advanced options. When you’re done, choose Next.

  6. 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.

  7. Choose Create to deploy the stack.

  8. Monitor the status of the stack. When the status is CREATE_COMPLETE, the CI/CD pipeline for AWS CloudFormation templates is ready.

    The Outputs tab for the stack will provide information about the resources that were created, as shown in Figure 2.

    
                        Quick Start stack outputs

    Figure 2: Quick Start stack outputs