diff --git a/website/Gemfile.lock b/website/Gemfile.lock index 8e4867a68..826d25e8f 100644 --- a/website/Gemfile.lock +++ b/website/Gemfile.lock @@ -180,6 +180,3 @@ PLATFORMS DEPENDENCIES middleman-hashicorp! - -BUNDLED WITH - 1.10.5 diff --git a/website/source/docs/providers/aws/r/launch_configuration.html.markdown b/website/source/docs/providers/aws/r/launch_configuration.html.markdown index 8b8507d52..ea96503dc 100644 --- a/website/source/docs/providers/aws/r/launch_configuration.html.markdown +++ b/website/source/docs/providers/aws/r/launch_configuration.html.markdown @@ -10,8 +10,6 @@ description: |- Provides a resource to create a new launch configuration, used for autoscaling groups. -~> **NOTE:** You may want to omit `name` attribute from attached `aws_launch_configuration`. When you [create](http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/LaunchConfiguration.html) a launch configuration, you cannot edit it. Terraform will treat a change in this resource as a destroy and create action. If you add a name to your launch configuration, then terraform will not be able to create the replacement launch configuration due to the name being the same. - ## Example Usage ``` @@ -22,6 +20,39 @@ resource "aws_launch_configuration" "as_conf" { } ``` +## Using with AutoScaling Groups + +Launch Configurations cannot be updated after creation with the Amazon +Web Service API. In order to update a Launch Configuration, Terraform will +destroy the existing resource and create a replacement. If order to effectively +use a Launch Configuration resource with an[AutoScaling Group resource][1], +it's recommend to omit the Launch Configuration `name` attribute, and +specify `create_before_destroy` in a [lifecycle][2] block, as shown: + +``` +resource "aws_launch_configuration" "as_conf" { + image_id = "ami-1234" + instance_type = "m1.small" + + lifecycle { + create_before_destroy = true + } +} + +resource "aws_autoscaling_group" "bar" { + name = "terraform-asg-example" + launch_configuration = "${aws_launch_configuration.as_conf.name}" + + lifecycle { + create_before_destroy = true + } +} +``` + +With this setup Terraform generates a unique name for your Launch +Configuration and can then update the AutoScaling Group without conflict before +destroying the previous Launch Configuration. + ## Argument Reference The following arguments are supported: @@ -100,3 +131,6 @@ configuration, resource recreation can be manually triggered by using the The following attributes are exported: * `id` - The ID of the launch configuration. + +[1]: /docs/providers/aws/r/autoscaling_group.html +[2]: /docs/configuration/resources.html#lifecycle