Configuration

Configure project structure, environments, CI/CD workflows, and code quality tools for the AWS CloudFormation Starter Kit.


Overview

The Configuration section explains how the repository is structured and how to tune it for the accounts and regions you manage.

Configuration pages

PageWhat it covers
Project StructureDirectory layout, templates, parameters, and workflows
EnvironmentsAdd, customize, and secure deployment targets
CI/CD WorkflowsGitHub Actions, Rain deployments, and monitoring
Linting and Code Analysiscfn-lint and Checkov configuration

Key concepts

Template and parameter pairing

The starter kit pairs templates with parameters by filename:

  • templates/oidc-provider.ymlparameters/test/oidc-provider.yml
  • templates/network.ymlparameters/production/network.yml

Environment isolation

Each environment has:

  • Dedicated parameter folder under parameters/<env>/
  • GitHub variable for account ID (<ENV>_AWS_ACCOUNT_ID)
  • Separate workflow for deployment

Automated validation

GitHub Actions workflows provide:

  • Template validation with cfn-lint
  • Security scanning with Checkov
  • Rain deployments on merge to main