Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 189 Commits
.github/workflows		.github/workflows
docs		docs
examples		examples
wrappers		wrappers
.editorconfig		.editorconfig
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.releaserc.json		.releaserc.json
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
main.tf		main.tf
outputs.tf		outputs.tf
variables.tf		variables.tf
versions.tf		versions.tf

Repository files navigation

AWS Auto Scaling Group (ASG) Terraform module

Terraform module which creates Auto Scaling resources on AWS.

Available Features

Autoscaling group with launch template - either created by the module or utilizing an existing launch template
Autoscaling group utilizing mixed instances policy
Ability to configure autoscaling groups to set instance refresh configuration and add lifecycle hooks
Ability to create an autoscaling group that respectsdesired_capacity or one that ignores to allow for scaling without conflicting Terraform diffs
IAM role and instance profile creation

Usage

module"asg" {source="terraform-aws-modules/autoscaling/aws"# Autoscaling groupname="example-asg"min_size=0max_size=1desired_capacity=1wait_for_capacity_timeout=0health_check_type="EC2"vpc_zone_identifier=["subnet-1235678","subnet-87654321"]initial_lifecycle_hooks=[    {      name="ExampleStartupLifeCycleHook"      default_result="CONTINUE"      heartbeat_timeout=60      lifecycle_transition="autoscaling:EC2_INSTANCE_LAUNCHING"      notification_metadata=jsonencode({"hello" ="world" })    },    {      name="ExampleTerminationLifeCycleHook"      default_result="CONTINUE"      heartbeat_timeout=180      lifecycle_transition="autoscaling:EC2_INSTANCE_TERMINATING"      notification_metadata=jsonencode({"goodbye" ="world" })    }  ]instance_refresh={    strategy="Rolling"    preferences= {      checkpoint_delay=600      checkpoint_percentages= [35,70,100]      instance_warmup=300      min_healthy_percentage=50      max_healthy_percentage=100    }    triggers= ["tag"]  }# Launch templatelaunch_template_name="example-asg"launch_template_description="Launch template example"update_default_version=trueimage_id="ami-ebd02392"instance_type="t3.micro"ebs_optimized=trueenable_monitoring=true# IAM role & instance profilecreate_iam_instance_profile=trueiam_role_name="example-asg"iam_role_path="/ec2/"iam_role_description="IAM role example"iam_role_tags={    CustomIamRole="Yes"  }iam_role_policies={    AmazonSSMManagedInstanceCore="arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore"  }block_device_mappings=[    {# Root volume      device_name="/dev/xvda"      no_device=0      ebs= {        delete_on_termination=true        encrypted=true        volume_size=20        volume_type="gp2"      }    }, {      device_name="/dev/sda1"      no_device=1      ebs= {        delete_on_termination=true        encrypted=true        volume_size=30        volume_type="gp2"      }    }  ]capacity_reservation_specification={    capacity_reservation_preference="open"  }cpu_options={    core_count=1    threads_per_core=1  }credit_specification={    cpu_credits="standard"  }instance_market_options={    market_type="spot"    spot_options= {      block_duration_minutes=60    }  }# This will ensure imdsv2 is enabled, required, and a single hop which is aws security# best practices# See https://docs.aws.amazon.com/securityhub/latest/userguide/autoscaling-controls.html#autoscaling-4metadata_options={    http_endpoint="enabled"    http_tokens="required"    http_put_response_hop_limit=1  }network_interfaces=[    {      delete_on_termination=true      description="eth0"      device_index=0      security_groups= ["sg-12345678"]    },    {      delete_on_termination=true      description="eth1"      device_index=1      security_groups= ["sg-12345678"]    }  ]placement={    availability_zone="us-west-1b"  }tag_specifications=[    {      resource_type="instance"      tags= { WhatAmI="Instance" }    },    {      resource_type="volume"      tags= { WhatAmI="Volume" }    },    {      resource_type="spot-instances-request"      tags= { WhatAmI="SpotInstanceRequest" }    }  ]tags={    Environment="dev"    Project="megasecret"  }}

Conditional creation

The following combinations are supported to conditionally create resources and/or use externally created resources within the module:

Note: the default behavior of the module is to create an autoscaling group and launch template.

Disable resource creation (no resources created):

create=falsecreate_launch_template=false

Create only a launch template:

create=false

Create an autoscaling group using an externally created launch template:

create_launch_template=falselaunch_template=aws_launch_template.my_launch_template.name

Create an autoscaling group with a mixed instance policy:

use_mixed_instances_policy=true

Create the autoscaling policies:

scaling_policies={    my-policy= {      policy_type="TargetTrackingScaling"      target_tracking_configuration= {        predefined_metric_specification= {          predefined_metric_type="ASGAverageCPUUtilization"          resource_label="MyLabel"        }        target_value=50.0      }    }  }

Examples

Complete - Creates several variations of resources for autoscaling groups and launch templates.

Requirements

Name	Version
terraform	>= 1.5.7
aws	>= 6.0

Providers

Name	Version
aws	>= 6.0

Modules

No modules.

Resources

Name	Type
aws_autoscaling_group.idc	resource
aws_autoscaling_group.this	resource
aws_autoscaling_policy.this	resource
aws_autoscaling_schedule.this	resource
aws_autoscaling_traffic_source_attachment.this	resource
aws_iam_instance_profile.this	resource
aws_iam_role.this	resource
aws_iam_role_policy_attachment.this	resource
aws_launch_template.this	resource
aws_iam_policy_document.assume_role_policy	data source
aws_partition.current	data source

Inputs

Name	Description	Type	Default	Required
autoscaling_group_tags	A map of additional tags to add to the autoscaling group	`map(string)`	`{}`	no
autoscaling_group_tags_not_propagate_at_launch	A list of tag keys that should NOT be propagated to launched EC2 instances	`list(string)`	`[]`	no
availability_zone_distribution	A map of configuration for capacity distribution across availability zones	object({ capacity_distribution_strategy = optional(string) })	`null`	no
availability_zones	A list of Availability Zones where instances in the Auto Scaling group can be created. Used for launching into the default VPC subnet in each Availability Zone when not using the`vpc_zone_identifier` attribute, or for attaching a network interface when an existing network interface ID is specified in a launch template. Conflicts with`vpc_zone_identifier`	`list(string)`	`null`	no
block_device_mappings	Specify volumes to attach to the instance besides the volumes specified by the AMI	list(object({ device_name = optional(string) ebs = optional(object({ delete_on_termination = optional(bool) encrypted = optional(bool) iops = optional(number) kms_key_id = optional(string) snapshot_id = optional(string) throughput = optional(number) volume_initialization_rate = optional(number) volume_size = optional(number) volume_type = optional(string) })) no_device = optional(string) virtual_name = optional(string) }))	`null`	no
capacity_rebalance	Indicates whether capacity rebalance is enabled	`bool`	`null`	no
capacity_reservation_specification	Targeting for EC2 capacity reservations	object({ capacity_reservation_preference = optional(string) capacity_reservation_target = optional(object({ capacity_reservation_id = optional(string) capacity_reservation_resource_group_arn = optional(string) })) })	`null`	no
context	Reserved	`string`	`null`	no
cpu_options	The CPU options for the instance	object({ amd_sev_snp = optional(string) core_count = optional(number) threads_per_core = optional(number) })	`null`	no
create	Determines whether to create autoscaling group or not	`bool`	`true`	no
create_iam_instance_profile	Determines whether an IAM instance profile is created or to use an existing IAM instance profile	`bool`	`false`	no
create_launch_template	Determines whether to create launch template or not	`bool`	`true`	no
credit_specification	Customize the credit specification of the instance	object({ cpu_credits = optional(string) })	`null`	no
default_cooldown	The amount of time, in seconds, after a scaling activity completes before another scaling activity can start	`number`	`null`	no
default_instance_warmup	Amount of time, in seconds, until a newly launched instance can contribute to the Amazon CloudWatch metrics. This delay lets an instance finish initializing before Amazon EC2 Auto Scaling aggregates instance metrics, resulting in more reliable usage data. Set this value equal to the amount of time that it takes for resource consumption to become stable after an instance reaches the InService state.	`number`	`null`	no
default_version	Default Version of the launch template	`string`	`null`	no
desired_capacity	The number of Amazon EC2 instances that should be running in the autoscaling group	`number`	`null`	no
desired_capacity_type	The unit of measurement for the value specified for desired_capacity. Supported for attribute-based instance type selection only. Valid values:`units`,`vcpu`,`memory-mib`.	`string`	`null`	no
disable_api_stop	If true, enables EC2 instance stop protection	`bool`	`null`	no
disable_api_termination	If true, enables EC2 instance termination protection	`bool`	`null`	no
ebs_optimized	If true, the launched EC2 instance will be EBS-optimized	`bool`	`null`	no
enable_monitoring	Enables/disables detailed monitoring	`bool`	`true`	no
enabled_metrics	A list of metrics to collect. The allowed values are`GroupDesiredCapacity`,`GroupInServiceCapacity`,`GroupPendingCapacity`,`GroupMinSize`,`GroupMaxSize`,`GroupInServiceInstances`,`GroupPendingInstances`,`GroupStandbyInstances`,`GroupStandbyCapacity`,`GroupTerminatingCapacity`,`GroupTerminatingInstances`,`GroupTotalCapacity`,`GroupTotalInstances`	`list(string)`	`[]`	no
enclave_options	Enable Nitro Enclaves on launched instances	object({ enabled = optional(bool) })	`null`	no
force_delete	Allows deleting the Auto Scaling Group without waiting for all instances in the pool to terminate. You can force an Auto Scaling Group to delete even if it's in the process of scaling a resource. Normally, Terraform drains all the instances before deleting the group. This bypasses that behavior and potentially leaves resources dangling	`bool`	`null`	no
force_delete_warm_pool	Allows deleting the Auto Scaling Group without waiting for all instances in the warm pool to terminate	`bool`	`null`	no
health_check_grace_period	Time (in seconds) after instance comes into service before checking health	`number`	`null`	no
health_check_type	`EC2` or`ELB`. Controls how health checking is done	`string`	`null`	no
hibernation_options	The hibernation options for the instance	object({ configured = optional(bool) })	`null`	no
iam_instance_profile_arn	Amazon Resource Name (ARN) of an existing IAM instance profile. Used when`create_iam_instance_profile` =`false`	`string`	`null`	no
iam_instance_profile_name	The name of the IAM instance profile to be created (`create_iam_instance_profile` =`true`) or existing (`create_iam_instance_profile` =`false`)	`string`	`null`	no
iam_role_description	Description of the role	`string`	`null`	no
iam_role_name	Name to use on IAM role created	`string`	`null`	no
iam_role_path	IAM role path	`string`	`null`	no
iam_role_permissions_boundary	ARN of the policy that is used to set the permissions boundary for the IAM role	`string`	`null`	no
iam_role_policies	IAM policies to attach to the IAM role	`map(string)`	`{}`	no
iam_role_tags	A map of additional tags to add to the IAM role created	`map(string)`	`{}`	no
iam_role_use_name_prefix	Determines whether the IAM role name (`iam_role_name`) is used as a prefix	`bool`	`true`	no
ignore_desired_capacity_changes	Determines whether the`desired_capacity` value is ignored after initial apply. See README note for more details	`bool`	`false`	no
ignore_failed_scaling_activities	Whether to ignore failed Auto Scaling scaling activities while waiting for capacity. The default is false -- failed scaling activities cause errors to be returned.	`bool`	`false`	no
image_id	The AMI from which to launch the instance	`string`	`null`	no
initial_lifecycle_hooks	One or more Lifecycle Hooks to attach to the Auto Scaling Group before instances are launched. The syntax is exactly the same as the separate`aws_autoscaling_lifecycle_hook` resource, without the`autoscaling_group_name` attribute. Please note that this will only work when creating a new Auto Scaling Group. For all other use-cases, please use`aws_autoscaling_lifecycle_hook` resource	list(object({ default_result = optional(string) heartbeat_timeout = optional(number) lifecycle_transition = string name = string notification_metadata = optional(string) notification_target_arn = optional(string) role_arn = optional(string) }))	`null`	no
instance_initiated_shutdown_behavior	Shutdown behavior for the instance. Can be`stop` or`terminate`. (Default:`stop`)	`string`	`null`	no
instance_maintenance_policy	If this block is configured, add a instance maintenance policy to the specified Auto Scaling group	object({ max_healthy_percentage = number min_healthy_percentage = number })	`null`	no
instance_market_options	The market (purchasing) option for the instance	object({ market_type = optional(string) spot_options = optional(object({ block_duration_minutes = optional(number) instance_interruption_behavior = optional(string) max_price = optional(string) spot_instance_type = optional(string) valid_until = optional(string) })) })	`null`	no
instance_name	Name that is propogated to launched EC2 instances via a tag - if not provided, defaults to`var.name`	`string`	`""`	no
instance_refresh	If this block is configured, start an Instance Refresh when this Auto Scaling Group is updated	object({ preferences = optional(object({ alarm_specification = optional(object({ alarms = optional(list(string)) })) auto_rollback = optional(bool) checkpoint_delay = optional(number) checkpoint_percentages = optional(list(number)) instance_warmup = optional(number) max_healthy_percentage = optional(number) min_healthy_percentage = optional(number) scale_in_protected_instances = optional(string) skip_matching = optional(bool) standby_instances = optional(string) })) strategy = string triggers = optional(list(string)) })	`null`	no
instance_requirements	The attribute requirements for the type of instance. If present then`instance_type` cannot be present	object({ accelerator_count = optional(object({ max = optional(number) min = optional(number) })) accelerator_manufacturers = optional(list(string)) accelerator_names = optional(list(string)) accelerator_total_memory_mib = optional(object({ max = optional(number) min = optional(number) })) accelerator_types = optional(list(string)) allowed_instance_types = optional(list(string)) bare_metal = optional(string) baseline_ebs_bandwidth_mbps = optional(object({ max = optional(number) min = optional(number) })) burstable_performance = optional(string) cpu_manufacturers = optional(list(string)) excluded_instance_types = optional(list(string)) instance_generations = optional(list(string)) local_storage = optional(string) local_storage_types = optional(list(string)) max_spot_price_as_percentage_of_optimal_on_demand_price = optional(number) memory_gib_per_vcpu = optional(object({ max = optional(number) min = optional(number) })) memory_mib = optional(object({ max = optional(number) min = optional(number) })) network_bandwidth_gbps = optional(object({ max = optional(number) min = optional(number) })) network_interface_count = optional(object({ max = optional(number) min = optional(number) })) on_demand_max_price_percentage_over_lowest_price = optional(number) require_hibernate_support = optional(bool) spot_max_price_percentage_over_lowest_price = optional(number) total_local_storage_gb = optional(object({ max = optional(number) min = optional(number) })) vcpu_count = optional(object({ max = optional(number) min = string })) })	`null`	no
instance_type	The type of the instance. If present then`instance_requirements` cannot be present	`string`	`null`	no
kernel_id	The kernel ID	`string`	`null`	no
key_name	The key name that should be used for the instance	`string`	`null`	no
launch_template_description	Description of the launch template	`string`	`null`	no
launch_template_id	ID of an existing launch template to be used (created outside of this module)	`string`	`null`	no
launch_template_name	Name of launch template to be created	`string`	`""`	no
launch_template_tags	A map of additional tags to add to the launch template	`map(string)`	`{}`	no
launch_template_use_name_prefix	Determines whether to use`launch_template_name` as is or create a unique name beginning with the`launch_template_name` as the prefix	`bool`	`true`	no
launch_template_version	Launch template version. Can be version number,`$Latest`, or`$Default`	`string`	`null`	no
license_specifications	A list of license specifications to associate with	list(object({ license_configuration_arn = string }))	`null`	no
maintenance_options	The maintenance options for the instance	object({ auto_recovery = optional(string) })	`null`	no
max_instance_lifetime	The maximum amount of time, in seconds, that an instance can be in service, values must be either equal to 0 or between 86400 and 31536000 seconds	`number`	`null`	no
max_size	The maximum size of the autoscaling group	`number`	`null`	no
metadata_options	Customize the metadata options for the instance	object({ http_endpoint = optional(string, "enabled") http_protocol_ipv6 = optional(string) http_put_response_hop_limit = optional(number, 1) http_tokens = optional(string, "required") instance_metadata_tags = optional(string) })	{ "http_endpoint": "enabled", "http_put_response_hop_limit": 1, "http_tokens": "required" }	no
metrics_granularity	The granularity to associate with the metrics to collect. The only valid value is`1Minute`	`string`	`null`	no
min_elb_capacity	Setting this causes Terraform to wait for this number of instances to show up healthy in the ELB only on creation. Updates will not wait on ELB instance number changes	`number`	`null`	no
min_size	The minimum size of the autoscaling group	`number`	`null`	no
mixed_instances_policy	Configuration block containing settings to define launch targets for Auto Scaling groups	object({ instances_distribution = optional(object({ on_demand_allocation_strategy = optional(string) on_demand_base_capacity = optional(number) on_demand_percentage_above_base_capacity = optional(number) spot_allocation_strategy = optional(string) spot_instance_pools = optional(number) spot_max_price = optional(string) })) launch_template = object({ override = optional(list(object({ instance_requirements = optional(object({ accelerator_count = optional(object({ max = optional(number) min = optional(number) })) accelerator_manufacturers = optional(list(string)) accelerator_names = optional(list(string)) accelerator_total_memory_mib = optional(object({ max = optional(number) min = optional(number) })) accelerator_types = optional(list(string)) allowed_instance_types = optional(list(string)) bare_metal = optional(string) baseline_ebs_bandwidth_mbps = optional(object({ max = optional(number) min = optional(number) })) burstable_performance = optional(string) cpu_manufacturers = optional(list(string)) excluded_instance_types = optional(list(string)) instance_generations = optional(list(string)) local_storage = optional(string) local_storage_types = optional(list(string)) max_spot_price_as_percentage_of_optimal_on_demand_price = optional(number) memory_gib_per_vcpu = optional(object({ max = optional(number) min = optional(number) })) memory_mib = optional(object({ max = optional(number) min = optional(number) })) network_bandwidth_gbps = optional(object({ max = optional(number) min = optional(number) })) network_interface_count = optional(object({ max = optional(number) min = optional(number) })) on_demand_max_price_percentage_over_lowest_price = optional(number) require_hibernate_support = optional(bool) spot_max_price_percentage_over_lowest_price = optional(number) total_local_storage_gb = optional(object({ max = optional(number) min = optional(number) })) vcpu_count = optional(object({ max = optional(number) min = optional(number) })) })) instance_type = optional(string) launch_template_specification = optional(object({ launch_template_id = optional(string) launch_template_name = optional(string) version = optional(string) })) weighted_capacity = optional(string) }))) }) })	`null`	no
name	Name used across the resources created	`string`	n/a	yes
network_interfaces	Customize network interfaces to be attached at instance boot time	list(object({ associate_carrier_ip_address = optional(bool) associate_public_ip_address = optional(bool) connection_tracking_specification = optional(object({ tcp_established_timeout = optional(number) udp_stream_timeout = optional(number) udp_timeout = optional(number) })) delete_on_termination = optional(bool) description = optional(string) device_index = optional(number) ena_srd_specification = optional(object({ ena_srd_enabled = optional(bool) ena_srd_udp_specification = optional(object({ ena_srd_udp_enabled = optional(bool) })) })) interface_type = optional(string) ipv4_address_count = optional(number) ipv4_addresses = optional(list(string)) ipv4_prefix_count = optional(number) ipv4_prefixes = optional(list(string)) ipv6_address_count = optional(number) ipv6_addresses = optional(list(string)) ipv6_prefix_count = optional(number) ipv6_prefixes = optional(list(string)) network_card_index = optional(number) network_interface_id = optional(string) primary_ipv6 = optional(bool) private_ip_address = optional(string) security_groups = optional(list(string), []) subnet_id = optional(string) }))	`null`	no
placement	The placement of the instance	object({ affinity = optional(string) availability_zone = optional(string) group_name = optional(string) host_id = optional(string) host_resource_group_arn = optional(string) partition_number = optional(number) spread_domain = optional(string) tenancy = optional(string) })	`null`	no
placement_group	The name of the placement group into which you'll launch your instances, if any	`string`	`null`	no
private_dns_name_options	The options for the instance hostname. The default values are inherited from the subnet	object({ enable_resource_name_dns_aaaa_record = optional(bool) enable_resource_name_dns_a_record = optional(bool) hostname_type = optional(string) })	`null`	no
protect_from_scale_in	Allows setting instance protection. The autoscaling group will not select instances with this setting for termination during scale in events.	`bool`	`false`	no
putin_khuylo	Do you agree that Putin doesn't respect Ukrainian sovereignty and territorial integrity? More info:https://en.wikipedia.org/wiki/Putin_khuylo!	`bool`	`true`	no
ram_disk_id	The ID of the ram disk	`string`	`null`	no
region	Region where the resource(s) will be managed. Defaults to the Region set in the provider configuration	`string`	`null`	no
scaling_policies	Map of target scaling policy schedule to create	map(object({ adjustment_type = optional(string) cooldown = optional(number) enabled = optional(bool) estimated_instance_warmup = optional(number) metric_aggregation_type = optional(string) min_adjustment_magnitude = optional(number) name = optional(string) # Will fall back to the map key if not provided policy_type = optional(string) predictive_scaling_configuration = optional(object({ max_capacity_breach_behavior = optional(string) max_capacity_buffer = optional(number) metric_specification = object({ customized_capacity_metric_specification = optional(object({ metric_data_queries = optional(list(object({ expression = optional(string) id = string label = optional(string) metric_stat = optional(object({ metric = object({ dimensions = optional(list(object({ name = string value = string }))) metric_name = string namespace = string }) stat = string unit = optional(string) })) return_data = optional(bool) }))) })) customized_load_metric_specification = optional(object({ metric_data_queries = optional(list(object({ expression = optional(string) id = string label = optional(string) metric_stat = optional(object({ metric = object({ dimensions = optional(list(object({ name = string value = string }))) metric_name = string namespace = string }) stat = string unit = optional(string) })) return_data = optional(bool) }))) })) customized_scaling_metric_specification = optional(object({ metric_data_queries = optional(list(object({ expression = optional(string) id = string label = optional(string) metric_stat = optional(object({ metric = object({ dimensions = optional(list(object({ name = string value = string }))) metric_name = string namespace = string }) stat = string unit = optional(string) })) return_data = optional(bool) }))) })) predefined_load_metric_specification = optional(object({ predefined_metric_type = string resource_label = optional(string) })) predefined_metric_pair_specification = optional(object({ predefined_metric_type = string resource_label = optional(string) })) predefined_scaling_metric_specification = optional(object({ predefined_metric_type = string resource_label = optional(string) })) target_value = optional(number) }) mode = optional(string) scheduling_buffer_time = optional(number) })) scaling_adjustment = optional(number) step_adjustment = optional(list(object({ metric_interval_lower_bound = optional(number) metric_interval_upper_bound = optional(number) scaling_adjustment = number }))) target_tracking_configuration = optional(object({ customized_metric_specification = optional(object({ metric_dimension = optional(list(object({ name = string value = string }))) metric_name = optional(string) metrics = optional(list(object({ expression = optional(string) id = string label = optional(string) metric_stat = optional(object({ metric = object({ dimensions = optional(list(object({ name = string value = string }))) metric_name = string namespace = string }) period = optional(number) stat = string unit = optional(string) })) return_data = optional(bool) }))) namespace = optional(string) period = optional(number) statistic = optional(string) unit = optional(string) })) disable_scale_in = optional(bool) predefined_metric_specification = optional(object({ predefined_metric_type = string resource_label = optional(string) })) target_value = number })) }))	`null`	no
schedules	Map of autoscaling group schedule to create	map(object({ desired_capacity = optional(number) end_time = optional(string) max_size = optional(number) min_size = optional(number) recurrence = optional(string) start_time = optional(string) time_zone = optional(string) }))	`null`	no
security_groups	A list of security group IDs to associate	`list(string)`	`[]`	no
service_linked_role_arn	The ARN of the service-linked role that the ASG will use to call other AWS services	`string`	`null`	no
suspended_processes	A list of processes to suspend for the Auto Scaling Group. The allowed values are`Launch`,`Terminate`,`HealthCheck`,`ReplaceUnhealthy`,`AZRebalance`,`AlarmNotification`,`ScheduledActions`,`AddToLoadBalancer`,`InstanceRefresh`. Note that if you suspend either the`Launch` or`Terminate` process types, it can prevent your Auto Scaling Group from functioning properly	`list(string)`	`[]`	no
tag_specifications	The tags to apply to the resources during launch	list(object({ resource_type = optional(string) tags = optional(map(string), {}) }))	`null`	no
tags	A map of tags to assign to resources	`map(string)`	`{}`	no
termination_policies	A list of policies to decide how the instances in the Auto Scaling Group should be terminated. The allowed values are`OldestInstance`,`NewestInstance`,`OldestLaunchConfiguration`,`ClosestToNextInstanceHour`,`OldestLaunchTemplate`,`AllocationStrategy`,`Default`	`list(string)`	`[]`	no
timeouts	Timeout configurations for the autoscaling group	object({ delete = optional(string) })	`null`	no
traffic_source_attachments	Map of traffic source attachment definitions to create	map(object({ traffic_source_identifier = string traffic_source_type = optional(string, "elbv2") }))	`null`	no
update_default_version	Whether to update Default Version each update. Conflicts with`default_version`	`bool`	`null`	no
use_mixed_instances_policy	Determines whether to use a mixed instances policy in the autoscaling group or not	`bool`	`false`	no
use_name_prefix	Determines whether to use`name` as is or create a unique name beginning with the`name` as the prefix	`bool`	`true`	no
user_data	The Base64-encoded user data to provide when launching the instance	`string`	`null`	no
vpc_zone_identifier	A list of subnet IDs to launch resources in. Subnets automatically determine which availability zones the group will reside. Conflicts with`availability_zones`	`list(string)`	`null`	no
wait_for_capacity_timeout	A maximum duration that Terraform should wait for ASG instances to be healthy before timing out. (See also Waiting for Capacity below.) Setting this to '0' causes Terraform to skip all Capacity Waiting behavior.	`string`	`null`	no
wait_for_elb_capacity	Setting this will cause Terraform to wait for exactly this number of healthy instances in all attached load balancers on both create and update operations. Takes precedence over`min_elb_capacity` behavior.	`number`	`null`	no
warm_pool	If this block is configured, add a Warm Pool to the specified Auto Scaling group	object({ instance_reuse_policy = optional(object({ reuse_on_scale_in = optional(bool) })) max_group_prepared_capacity = optional(number) min_size = optional(number) pool_state = optional(string) })	`null`	no

Outputs

Name	Description
autoscaling_group_arn	The ARN for this AutoScaling Group
autoscaling_group_availability_zones	The availability zones of the autoscale group
autoscaling_group_default_cooldown	Time between a scaling activity and the succeeding scaling activity
autoscaling_group_desired_capacity	The number of Amazon EC2 instances that should be running in the group
autoscaling_group_enabled_metrics	List of metrics enabled for collection
autoscaling_group_health_check_grace_period	Time after instance comes into service before checking health
autoscaling_group_health_check_type	EC2 or ELB. Controls how health checking is done
autoscaling_group_id	The autoscaling group id
autoscaling_group_load_balancers	The load balancer names associated with the autoscaling group
autoscaling_group_max_size	The maximum size of the autoscale group
autoscaling_group_min_size	The minimum size of the autoscale group
autoscaling_group_name	The autoscaling group name
autoscaling_group_target_group_arns	List of Target Group ARNs that apply to this AutoScaling Group
autoscaling_group_vpc_zone_identifier	The VPC zone identifier
autoscaling_policy_arns	ARNs of autoscaling policies
autoscaling_schedule_arns	ARNs of autoscaling group schedules
iam_instance_profile_arn	ARN assigned by AWS to the instance profile
iam_instance_profile_id	Instance profile's ID
iam_instance_profile_unique	Stable and unique string identifying the IAM instance profile
iam_role_arn	The Amazon Resource Name (ARN) specifying the IAM role
iam_role_name	The name of the IAM role
iam_role_unique_id	Stable and unique string identifying the IAM role
launch_template_arn	The ARN of the launch template
launch_template_default_version	The default version of the launch template
launch_template_id	The ID of the launch template
launch_template_latest_version	The latest version of the launch template
launch_template_name	The name of the launch template

Notes

A refresh will not start iflaunch_template_version is set to$Latest when using an external launch template. To trigger the refresh when the external launch template is changed, set this tolatest_version of thataws_launch_template resource.

Authors

Module is maintained byAnton Babenko with help fromthese awesome contributors.

License

Apache 2 Licensed. SeeLICENSE for full details.

Additional information for users from Russia and Belarus

Russia hasillegally annexed Crimea in 2014 andbrought the war in Donbas followed byfull-scale invasion of Ukraine in 2022.
Russia has brought sorrow and devastations to millions of Ukrainians, killed hundreds of innocent people, damaged thousands of buildings, and forced several million people to flee.
Putin khuylo!