TaskCat testing tool


All new Quick Starts and updates are validated by our internal automated validation and integration (CI/CD) system. As part of this process, the CloudFormation templates go through mandatory automated testing through a tool called TaskCat. TaskCat deploys your AWS CloudFormation template in multiple AWS Regions and generates a report with a pass/fail grade for each region. You can specify the regions and number of Availability Zones you want to include in the test, and pass in parameter values from your AWS CloudFormation template.


TaskCat is implemented as a Python class that you import, instantiate, and run. It was developed by the AWS Quick Start team to test AWS CloudFormation templates for Quick Starts. We’re pleased to make the tool available to all developers who want to validate their Quick Start templates during development, or test their custom AWS CloudFormation templates. TaskCat is available as an open-source tool in GitHub.

TaskCat supports all major Linux distributions and Mac OS X versions. If you are using Windows 10, we recommend that you install Windows Subsystem for Linux (WSL), and then install TaskCat within the WSL environment. For TaskCat installation instructions, see the Installation Section of the TaskCat Readme file in GitHub.

For an example Quick Start project and input files you can use to explore TaskCat, see the GitHub repository sample-taskcat-project.