terraform-aws-autoscaling

Description

A terraform module which provisions an auto scaling group along with its launch configuration.

Table of Content

• terraform-aws-autoscaling
  • Description
  • Dependencies
  • Getting Started
    • Conventions
    • Behaviour
    • Migration from pre-launch-template versions
    • Switching between plain launch template and mixed instance policy
  • Examples
  • Terraform Version
  • Requirements
  • Providers
  • Modules
  • Resources
  • Inputs
  • Outputs
  • Authors
  • Contributing
  • License

Dependencies

This Terraform module uses another Terraform module, here is the list of Terraform module dependencies:

• traveloka/terraform-aws-resource-naming

Getting Started

Conventions

• the auto scaling group will have Service, Cluster, Environment, and ProductDomain tags by default, which are propagated to all instances it spawns

Behaviour

• To specify on-demand instance types, use the launch_template_overrides variable. Auto Scaling will launch instances based on the order of preference specified in that list. ["c5.large", "c4.large", "m5.large"] means the ASG will always try to launch c5.large if it's available, falling back to c4.large if it's not available, and falling back to m5.large if the previous two aren't available
• On the first deployment, this module will provision an ASG with a launch template that select the most recent AMI that passes through the given image_filters
• Each time there's a change in the values of the module.asg_name's keepers (e.g. security group, AMI ID), a new ASG will be provisioned by terraform, and the old one will later be destroyed (doing the "simple swap" deployment strategy).
• When there's a change in launch template parameters' values, terraform will create a new launch template version unless the new configuration is already the same as the latest version of the launch template (e.g. when the launch template had been updated externally).

Migration from pre-launch-template versions

terraform init
terraform state rm module.<this module name in your terraform code>.module.random_lc
terraform apply

Switching between plain launch template and mixed instance policy

switching to plain launch template

module "asg" {
  source = "github.com/traveloka/terraform-aws-autoscaling?ref=v0.3.1"
  # ...
  use_mixed_instance_policy = false
  launch_template_overrides = [
    {
      "instance_type" = "c4.large" # this (the first element) will be the launch template's instance type
    },
    {
      "instance_type" = "t3.medium"
    },
  ]
}

switching to mixed instance policy

module "asg" {
  source = "github.com/traveloka/terraform-aws-autoscaling?ref=v0.3.1"
  # ...
  use_mixed_instance_policy = true
}

Examples

• Simple
• Public

Terraform Version

This module was created on 15/08/2018. The latest stable version of Terraform which this module tested working is Terraform 0.13.7 on 28/09/2021.

Requirements

Providers

Modules

Resources

Inputs

[
  "GroupMinSize",
  "GroupMaxSize",
  "GroupDesiredCapacity",
  "GroupInServiceInstances",
  "GroupPendingInstances",
  "GroupStandbyInstances",
  "GroupTerminatingInstances",
  "GroupTotalInstances"
]

[
  "Default"
]

list(object({
    name   = string,
    values = list(string)
    })
  )

[
  {
    "instance_type": "c4.large"
  },
  {
    "instance_type": "t3.medium"
  }
]

{
  "on_demand_allocation_strategy": "prioritized",
  "on_demand_base_capacity": "0",
  "on_demand_percentage_above_base_capacity": "100",
  "spot_allocation_strategy": "lowest-price",
  "spot_instance_pools": "2",
  "spot_max_price": ""
}

Outputs

Authors

• Salvian Reynaldi

Contributing

This module accepting or open for any contributions from anyone, please see the CONTRIBUTING.md for more detail about how to contribute to this module.

License

This module is under Apache License 2.0 - see the LICENSE file for details.