# Complete Auto Scaling Group Configuration in this directory creates several different variations of resources for autoscaling groups and launch templates. There are primarily six different setups shown in this example project: - `disabled` - demonstrates how to completely disable creation of both the autoscaling group and the associated launch template (no resources will be created) - `template only` - demonstrates how to create a launch template without creating an autoscaling group - `default` - demonstrates the bare minimum amount of information required to create an autoscaling group, relying mostly on default values - `external` - demonstrates how to create an autoscaling group using an externally created launch template - `complete` - demonstrates the vast majority of the functionality available for creating an autoscaling group - `mixed instance` - demonstrates how to create an autoscaling group configured to use a mixed instance policy - `warm pool` - demonstrates the usage of warm pools with capacity reservations - `efa` - demonstrates the usage of EFA (Elastic Fabric Adapter) type network interfaces ## Usage To run this example you need to execute: ```bash $ terraform init $ terraform plan $ terraform apply ``` Note that this example may create resources which cost money. Run `terraform destroy` when you don't need these resources. ## Requirements | Name | Version | | ---- | ------- | | [terraform](#requirement\_terraform) | >= 1.5.7 | | [aws](#requirement\_aws) | >= 6.56 | ## Providers | Name | Version | | ---- | ------- | | [aws](#provider\_aws) | >= 6.56 | ## Modules | Name | Source | Version | | ---- | ------ | ------- | | [alb](#module\_alb) | terraform-aws-modules/alb/aws | ~> 9.0 | | [asg\_sg](#module\_asg\_sg) | terraform-aws-modules/security-group/aws | ~> 5.0 | | [auto\_rollback](#module\_auto\_rollback) | terraform-aws-modules/cloudwatch/aws//modules/metric-alarm | ~> 4.3 | | [complete](#module\_complete) | ../../ | n/a | | [default](#module\_default) | ../../ | n/a | | [disabled](#module\_disabled) | ../../ | n/a | | [efa](#module\_efa) | ../../ | n/a | | [external](#module\_external) | ../../ | n/a | | [instance\_requirements](#module\_instance\_requirements) | ../../ | n/a | | [instance\_requirements\_accelerators](#module\_instance\_requirements\_accelerators) | ../../ | n/a | | [launch\_template\_only](#module\_launch\_template\_only) | ../../ | n/a | | [mixed\_instance](#module\_mixed\_instance) | ../../ | n/a | | [step\_scaling\_alarm](#module\_step\_scaling\_alarm) | terraform-aws-modules/cloudwatch/aws//modules/metric-alarm | ~> 4.3 | | [target\_tracking\_customized\_metrics](#module\_target\_tracking\_customized\_metrics) | ../../ | n/a | | [vpc](#module\_vpc) | terraform-aws-modules/vpc/aws | ~> 6.0 | | [warm\_pool](#module\_warm\_pool) | ../../ | n/a | ## Resources | Name | Type | | ---- | ---- | | [aws_ec2_capacity_reservation.targeted](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/ec2_capacity_reservation) | resource | | [aws_iam_instance_profile.ssm](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_instance_profile) | resource | | [aws_iam_role.ssm](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role) | resource | | [aws_iam_service_linked_role.autoscaling](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_service_linked_role) | resource | | [aws_launch_template.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/launch_template) | resource | | [aws_sqs_queue.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/sqs_queue) | resource | | [aws_ami.amazon_linux](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/ami) | data source | | [aws_availability_zones.available](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/availability_zones) | data source | ## Inputs No inputs. ## Outputs | Name | Description | | ---- | ----------- | | [complete\_autoscaling\_group\_arn](#output\_complete\_autoscaling\_group\_arn) | The ARN for this AutoScaling Group | | [complete\_autoscaling\_group\_availability\_zones](#output\_complete\_autoscaling\_group\_availability\_zones) | The availability zones of the autoscale group | | [complete\_autoscaling\_group\_default\_cooldown](#output\_complete\_autoscaling\_group\_default\_cooldown) | Time between a scaling activity and the succeeding scaling activity | | [complete\_autoscaling\_group\_desired\_capacity](#output\_complete\_autoscaling\_group\_desired\_capacity) | The number of Amazon EC2 instances that should be running in the group | | [complete\_autoscaling\_group\_enabled\_metrics](#output\_complete\_autoscaling\_group\_enabled\_metrics) | List of metrics enabled for collection | | [complete\_autoscaling\_group\_health\_check\_grace\_period](#output\_complete\_autoscaling\_group\_health\_check\_grace\_period) | Time after instance comes into service before checking health | | [complete\_autoscaling\_group\_health\_check\_type](#output\_complete\_autoscaling\_group\_health\_check\_type) | EC2 or ELB. Controls how health checking is done | | [complete\_autoscaling\_group\_id](#output\_complete\_autoscaling\_group\_id) | The autoscaling group id | | [complete\_autoscaling\_group\_load\_balancers](#output\_complete\_autoscaling\_group\_load\_balancers) | The load balancer names associated with the autoscaling group | | [complete\_autoscaling\_group\_max\_size](#output\_complete\_autoscaling\_group\_max\_size) | The maximum size of the autoscale group | | [complete\_autoscaling\_group\_min\_size](#output\_complete\_autoscaling\_group\_min\_size) | The minimum size of the autoscale group | | [complete\_autoscaling\_group\_name](#output\_complete\_autoscaling\_group\_name) | The autoscaling group name | | [complete\_autoscaling\_group\_target\_group\_arns](#output\_complete\_autoscaling\_group\_target\_group\_arns) | List of Target Group ARNs that apply to this AutoScaling Group | | [complete\_autoscaling\_group\_vpc\_zone\_identifier](#output\_complete\_autoscaling\_group\_vpc\_zone\_identifier) | The VPC zone identifier | | [complete\_autoscaling\_policy\_arns](#output\_complete\_autoscaling\_policy\_arns) | ARNs of autoscaling policies | | [complete\_autoscaling\_schedule\_arns](#output\_complete\_autoscaling\_schedule\_arns) | ARNs of autoscaling group schedules | | [complete\_iam\_instance\_profile\_arn](#output\_complete\_iam\_instance\_profile\_arn) | ARN assigned by AWS to the instance profile | | [complete\_iam\_instance\_profile\_id](#output\_complete\_iam\_instance\_profile\_id) | Instance profile's ID | | [complete\_iam\_instance\_profile\_unique](#output\_complete\_iam\_instance\_profile\_unique) | Stable and unique string identifying the IAM instance profile | | [complete\_iam\_role\_arn](#output\_complete\_iam\_role\_arn) | The Amazon Resource Name (ARN) specifying the IAM role | | [complete\_iam\_role\_name](#output\_complete\_iam\_role\_name) | The name of the IAM role | | [complete\_iam\_role\_unique\_id](#output\_complete\_iam\_role\_unique\_id) | Stable and unique string identifying the IAM role | | [complete\_launch\_template\_arn](#output\_complete\_launch\_template\_arn) | The ARN of the launch template | | [complete\_launch\_template\_default\_version](#output\_complete\_launch\_template\_default\_version) | The default version of the launch template | | [complete\_launch\_template\_id](#output\_complete\_launch\_template\_id) | The ID of the launch template | | [complete\_launch\_template\_latest\_version](#output\_complete\_launch\_template\_latest\_version) | The latest version of the launch template | | [complete\_launch\_template\_name](#output\_complete\_launch\_template\_name) | The name of the launch template | | [default\_autoscaling\_group\_arn](#output\_default\_autoscaling\_group\_arn) | The ARN for this AutoScaling Group | | [default\_autoscaling\_group\_availability\_zones](#output\_default\_autoscaling\_group\_availability\_zones) | The availability zones of the autoscale group | | [default\_autoscaling\_group\_default\_cooldown](#output\_default\_autoscaling\_group\_default\_cooldown) | Time between a scaling activity and the succeeding scaling activity | | [default\_autoscaling\_group\_desired\_capacity](#output\_default\_autoscaling\_group\_desired\_capacity) | The number of Amazon EC2 instances that should be running in the group | | [default\_autoscaling\_group\_enabled\_metrics](#output\_default\_autoscaling\_group\_enabled\_metrics) | List of metrics enabled for collection | | [default\_autoscaling\_group\_health\_check\_grace\_period](#output\_default\_autoscaling\_group\_health\_check\_grace\_period) | Time after instance comes into service before checking health | | [default\_autoscaling\_group\_health\_check\_type](#output\_default\_autoscaling\_group\_health\_check\_type) | EC2 or ELB. Controls how health checking is done | | [default\_autoscaling\_group\_id](#output\_default\_autoscaling\_group\_id) | The autoscaling group id | | [default\_autoscaling\_group\_load\_balancers](#output\_default\_autoscaling\_group\_load\_balancers) | The load balancer names associated with the autoscaling group | | [default\_autoscaling\_group\_max\_size](#output\_default\_autoscaling\_group\_max\_size) | The maximum size of the autoscale group | | [default\_autoscaling\_group\_min\_size](#output\_default\_autoscaling\_group\_min\_size) | The minimum size of the autoscale group | | [default\_autoscaling\_group\_name](#output\_default\_autoscaling\_group\_name) | The autoscaling group name | | [default\_autoscaling\_group\_target\_group\_arns](#output\_default\_autoscaling\_group\_target\_group\_arns) | List of Target Group ARNs that apply to this AutoScaling Group | | [default\_autoscaling\_group\_vpc\_zone\_identifier](#output\_default\_autoscaling\_group\_vpc\_zone\_identifier) | The VPC zone identifier | | [default\_iam\_instance\_profile\_arn](#output\_default\_iam\_instance\_profile\_arn) | ARN assigned by AWS to the instance profile | | [default\_iam\_instance\_profile\_id](#output\_default\_iam\_instance\_profile\_id) | Instance profile's ID | | [default\_iam\_instance\_profile\_unique](#output\_default\_iam\_instance\_profile\_unique) | Stable and unique string identifying the IAM instance profile | | [default\_iam\_role\_arn](#output\_default\_iam\_role\_arn) | The Amazon Resource Name (ARN) specifying the IAM role | | [default\_iam\_role\_name](#output\_default\_iam\_role\_name) | The name of the IAM role | | [default\_iam\_role\_unique\_id](#output\_default\_iam\_role\_unique\_id) | Stable and unique string identifying the IAM role | | [default\_launch\_template\_arn](#output\_default\_launch\_template\_arn) | The ARN of the launch template | | [default\_launch\_template\_default\_version](#output\_default\_launch\_template\_default\_version) | The default version of the launch template | | [default\_launch\_template\_id](#output\_default\_launch\_template\_id) | The ID of the launch template | | [default\_launch\_template\_latest\_version](#output\_default\_launch\_template\_latest\_version) | The latest version of the launch template | | [default\_launch\_template\_name](#output\_default\_launch\_template\_name) | The name of the launch template | | [external\_autoscaling\_group\_arn](#output\_external\_autoscaling\_group\_arn) | The ARN for this AutoScaling Group | | [external\_autoscaling\_group\_availability\_zones](#output\_external\_autoscaling\_group\_availability\_zones) | The availability zones of the autoscale group | | [external\_autoscaling\_group\_default\_cooldown](#output\_external\_autoscaling\_group\_default\_cooldown) | Time between a scaling activity and the succeeding scaling activity | | [external\_autoscaling\_group\_desired\_capacity](#output\_external\_autoscaling\_group\_desired\_capacity) | The number of Amazon EC2 instances that should be running in the group | | [external\_autoscaling\_group\_enabled\_metrics](#output\_external\_autoscaling\_group\_enabled\_metrics) | List of metrics enabled for collection | | [external\_autoscaling\_group\_health\_check\_grace\_period](#output\_external\_autoscaling\_group\_health\_check\_grace\_period) | Time after instance comes into service before checking health | | [external\_autoscaling\_group\_health\_check\_type](#output\_external\_autoscaling\_group\_health\_check\_type) | EC2 or ELB. Controls how health checking is done | | [external\_autoscaling\_group\_id](#output\_external\_autoscaling\_group\_id) | The autoscaling group id | | [external\_autoscaling\_group\_load\_balancers](#output\_external\_autoscaling\_group\_load\_balancers) | The load balancer names associated with the autoscaling group | | [external\_autoscaling\_group\_max\_size](#output\_external\_autoscaling\_group\_max\_size) | The maximum size of the autoscale group | | [external\_autoscaling\_group\_min\_size](#output\_external\_autoscaling\_group\_min\_size) | The minimum size of the autoscale group | | [external\_autoscaling\_group\_name](#output\_external\_autoscaling\_group\_name) | The autoscaling group name | | [external\_autoscaling\_group\_target\_group\_arns](#output\_external\_autoscaling\_group\_target\_group\_arns) | List of Target Group ARNs that apply to this AutoScaling Group | | [external\_autoscaling\_group\_vpc\_zone\_identifier](#output\_external\_autoscaling\_group\_vpc\_zone\_identifier) | The VPC zone identifier | | [external\_iam\_instance\_profile\_arn](#output\_external\_iam\_instance\_profile\_arn) | ARN assigned by AWS to the instance profile | | [external\_iam\_instance\_profile\_id](#output\_external\_iam\_instance\_profile\_id) | Instance profile's ID | | [external\_iam\_instance\_profile\_unique](#output\_external\_iam\_instance\_profile\_unique) | Stable and unique string identifying the IAM instance profile | | [external\_iam\_role\_arn](#output\_external\_iam\_role\_arn) | The Amazon Resource Name (ARN) specifying the IAM role | | [external\_iam\_role\_name](#output\_external\_iam\_role\_name) | The name of the IAM role | | [external\_iam\_role\_unique\_id](#output\_external\_iam\_role\_unique\_id) | Stable and unique string identifying the IAM role | | [external\_launch\_template\_arn](#output\_external\_launch\_template\_arn) | The ARN of the launch template | | [external\_launch\_template\_default\_version](#output\_external\_launch\_template\_default\_version) | The default version of the launch template | | [external\_launch\_template\_id](#output\_external\_launch\_template\_id) | The ID of the launch template | | [external\_launch\_template\_latest\_version](#output\_external\_launch\_template\_latest\_version) | The latest version of the launch template | | [external\_launch\_template\_name](#output\_external\_launch\_template\_name) | The name of the launch template | | [launch\_template\_only\_launch\_template\_arn](#output\_launch\_template\_only\_launch\_template\_arn) | The ARN of the launch template | | [launch\_template\_only\_launch\_template\_default\_version](#output\_launch\_template\_only\_launch\_template\_default\_version) | The default version of the launch template | | [launch\_template\_only\_launch\_template\_id](#output\_launch\_template\_only\_launch\_template\_id) | The ID of the launch template | | [launch\_template\_only\_launch\_template\_latest\_version](#output\_launch\_template\_only\_launch\_template\_latest\_version) | The latest version of the launch template | | [launch\_template\_only\_launch\_template\_name](#output\_launch\_template\_only\_launch\_template\_name) | The name of the launch template | | [mixed\_instance\_autoscaling\_group\_arn](#output\_mixed\_instance\_autoscaling\_group\_arn) | The ARN for this AutoScaling Group | | [mixed\_instance\_autoscaling\_group\_availability\_zones](#output\_mixed\_instance\_autoscaling\_group\_availability\_zones) | The availability zones of the autoscale group | | [mixed\_instance\_autoscaling\_group\_default\_cooldown](#output\_mixed\_instance\_autoscaling\_group\_default\_cooldown) | Time between a scaling activity and the succeeding scaling activity | | [mixed\_instance\_autoscaling\_group\_desired\_capacity](#output\_mixed\_instance\_autoscaling\_group\_desired\_capacity) | The number of Amazon EC2 instances that should be running in the group | | [mixed\_instance\_autoscaling\_group\_enabled\_metrics](#output\_mixed\_instance\_autoscaling\_group\_enabled\_metrics) | List of metrics enabled for collection | | [mixed\_instance\_autoscaling\_group\_health\_check\_grace\_period](#output\_mixed\_instance\_autoscaling\_group\_health\_check\_grace\_period) | Time after instance comes into service before checking health | | [mixed\_instance\_autoscaling\_group\_health\_check\_type](#output\_mixed\_instance\_autoscaling\_group\_health\_check\_type) | EC2 or ELB. Controls how health checking is done | | [mixed\_instance\_autoscaling\_group\_id](#output\_mixed\_instance\_autoscaling\_group\_id) | The autoscaling group id | | [mixed\_instance\_autoscaling\_group\_load\_balancers](#output\_mixed\_instance\_autoscaling\_group\_load\_balancers) | The load balancer names associated with the autoscaling group | | [mixed\_instance\_autoscaling\_group\_max\_size](#output\_mixed\_instance\_autoscaling\_group\_max\_size) | The maximum size of the autoscale group | | [mixed\_instance\_autoscaling\_group\_min\_size](#output\_mixed\_instance\_autoscaling\_group\_min\_size) | The minimum size of the autoscale group | | [mixed\_instance\_autoscaling\_group\_name](#output\_mixed\_instance\_autoscaling\_group\_name) | The autoscaling group name | | [mixed\_instance\_autoscaling\_group\_target\_group\_arns](#output\_mixed\_instance\_autoscaling\_group\_target\_group\_arns) | List of Target Group ARNs that apply to this AutoScaling Group | | [mixed\_instance\_autoscaling\_group\_vpc\_zone\_identifier](#output\_mixed\_instance\_autoscaling\_group\_vpc\_zone\_identifier) | The VPC zone identifier | | [mixed\_instance\_iam\_instance\_profile\_arn](#output\_mixed\_instance\_iam\_instance\_profile\_arn) | ARN assigned by AWS to the instance profile | | [mixed\_instance\_iam\_instance\_profile\_id](#output\_mixed\_instance\_iam\_instance\_profile\_id) | Instance profile's ID | | [mixed\_instance\_iam\_instance\_profile\_unique](#output\_mixed\_instance\_iam\_instance\_profile\_unique) | Stable and unique string identifying the IAM instance profile | | [mixed\_instance\_iam\_role\_arn](#output\_mixed\_instance\_iam\_role\_arn) | The Amazon Resource Name (ARN) specifying the IAM role | | [mixed\_instance\_iam\_role\_name](#output\_mixed\_instance\_iam\_role\_name) | The name of the IAM role | | [mixed\_instance\_iam\_role\_unique\_id](#output\_mixed\_instance\_iam\_role\_unique\_id) | Stable and unique string identifying the IAM role | | [mixed\_instance\_launch\_template\_arn](#output\_mixed\_instance\_launch\_template\_arn) | The ARN of the launch template | | [mixed\_instance\_launch\_template\_default\_version](#output\_mixed\_instance\_launch\_template\_default\_version) | The default version of the launch template | | [mixed\_instance\_launch\_template\_id](#output\_mixed\_instance\_launch\_template\_id) | The ID of the launch template | | [mixed\_instance\_launch\_template\_latest\_version](#output\_mixed\_instance\_launch\_template\_latest\_version) | The latest version of the launch template | | [mixed\_instance\_launch\_template\_name](#output\_mixed\_instance\_launch\_template\_name) | The name of the launch template | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_arn](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_arn) | The ARN for this AutoScaling Group | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_availability\_zones](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_availability\_zones) | The availability zones of the autoscale group | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_default\_cooldown](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_default\_cooldown) | Time between a scaling activity and the succeeding scaling activity | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_desired\_capacity](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_desired\_capacity) | The number of Amazon EC2 instances that should be running in the group | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_enabled\_metrics](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_enabled\_metrics) | List of metrics enabled for collection | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_health\_check\_grace\_period](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_health\_check\_grace\_period) | Time after instance comes into service before checking health | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_health\_check\_type](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_health\_check\_type) | EC2 or ELB. Controls how health checking is done | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_id](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_id) | The autoscaling group id | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_load\_balancers](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_load\_balancers) | The load balancer names associated with the autoscaling group | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_max\_size](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_max\_size) | The maximum size of the autoscale group | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_min\_size](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_min\_size) | The minimum size of the autoscale group | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_name](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_name) | The autoscaling group name | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_target\_group\_arns](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_target\_group\_arns) | List of Target Group ARNs that apply to this AutoScaling Group | | [target\_tracking\_customized\_metrics\_autoscaling\_group\_vpc\_zone\_identifier](#output\_target\_tracking\_customized\_metrics\_autoscaling\_group\_vpc\_zone\_identifier) | The VPC zone identifier | | [target\_tracking\_customized\_metrics\_iam\_instance\_profile\_arn](#output\_target\_tracking\_customized\_metrics\_iam\_instance\_profile\_arn) | ARN assigned by AWS to the instance profile | | [target\_tracking\_customized\_metrics\_iam\_instance\_profile\_id](#output\_target\_tracking\_customized\_metrics\_iam\_instance\_profile\_id) | Instance profile's ID | | [target\_tracking\_customized\_metrics\_iam\_instance\_profile\_unique](#output\_target\_tracking\_customized\_metrics\_iam\_instance\_profile\_unique) | Stable and unique string identifying the IAM instance profile | | [target\_tracking\_customized\_metrics\_iam\_role\_arn](#output\_target\_tracking\_customized\_metrics\_iam\_role\_arn) | The Amazon Resource Name (ARN) specifying the IAM role | | [target\_tracking\_customized\_metrics\_iam\_role\_name](#output\_target\_tracking\_customized\_metrics\_iam\_role\_name) | The name of the IAM role | | [target\_tracking\_customized\_metrics\_iam\_role\_unique\_id](#output\_target\_tracking\_customized\_metrics\_iam\_role\_unique\_id) | Stable and unique string identifying the IAM role | | [target\_tracking\_customized\_metrics\_launch\_template\_arn](#output\_target\_tracking\_customized\_metrics\_launch\_template\_arn) | The ARN of the launch template | | [target\_tracking\_customized\_metrics\_launch\_template\_default\_version](#output\_target\_tracking\_customized\_metrics\_launch\_template\_default\_version) | The default version of the launch template | | [target\_tracking\_customized\_metrics\_launch\_template\_id](#output\_target\_tracking\_customized\_metrics\_launch\_template\_id) | The ID of the launch template | | [target\_tracking\_customized\_metrics\_launch\_template\_latest\_version](#output\_target\_tracking\_customized\_metrics\_launch\_template\_latest\_version) | The latest version of the launch template | | [target\_tracking\_customized\_metrics\_launch\_template\_name](#output\_target\_tracking\_customized\_metrics\_launch\_template\_name) | The name of the launch template |

Changes from upstream