Terraform AWS StackSet Module

Description

The purpose of this module is to deploy a cloudformation stack to an AWS account. The module will also deploy a stackset to multiple accounts if required.

Usage

Add example usage here

module "stackset" {
  source = "../.."

  description               = "Used to deploy the default permissions boundary for the pipelines."
  enable_management_account = true
  name                      = "LZA-IAM-DefaultBoundary"
  region                    = "us-west-2"
  tags                      = {}
  template                  = file("assets/default-boundary.yml")
  parameters                = {}
}

Update Documentation

The terraform-docs utility is used to generate this README. Follow the below steps to update:

1. Make changes to the .terraform-docs.yml file
2. Fetch the terraform-docs binary (https://terraform-docs.io/user-guide/installation/)
3. Run terraform-docs markdown table --output-file ${PWD}/README.md --output-mode inject .

Requirements

Name	Version
terraform	>= 1.0.7
aws	>= 5.0.0

Providers

Name	Version
aws	>= 5.0.0

Modules

No modules.

Resources

Name	Type
aws_cloudformation_stack_set.stackset	resource
aws_cloudformation_stack_set_instance.ou	resource
aws_region.current	data source

Inputs

Name	Description	Type	Default	Required
description	The description of the cloudformation stack	string	n/a	yes
name	The name of the cloudformation stack	string	n/a	yes
tags	The tags to apply to the cloudformation stack	map(string)	n/a	yes
template	The body of the cloudformation template to deploy	string	n/a	yes
capabilities	The capabilities required to deploy the cloudformation template	list(string)	[ "CAPABILITY_NAMED_IAM", "CAPABILITY_AUTO_EXPAND", "CAPABILITY_IAM" ]	no
failure_tolerance_count	The number of failures that are tolerated before the stack operation is stopped	number	0	no
max_concurrent_count	The maximum number of concurrent deployments	number	10	no
organizational_units	The organizational units to deploy the stackset to	list(string)	[]	no
parameters	The parameters to pass to the cloudformation template	map(string)	{}	no
region	The region to deploy the cloudformation template	string	null	no
retain_stacks_on_account_removal	Whether to retain stacks on account removal	bool	true	no

Outputs

No outputs.