AWS AWSCloudFormation documentation change
Summary
Updated terminology from 'Auto Scaling group' to 'Amazon EC2 Auto Scaling group' throughout the document for branding consistency
Security assessment
The changes are purely terminological updates to use the full service name ('Amazon EC2 Auto Scaling group') rather than addressing security vulnerabilities or documenting security features. No security-related content was added or modified beyond naming conventions.
Diff
diff --git a/AWSCloudFormation/latest/UserGuide/quickref-ec2-auto-scaling.md b/AWSCloudFormation/latest/UserGuide/quickref-ec2-auto-scaling.md index fff21f90c..2a3591781 100644 --- a//AWSCloudFormation/latest/UserGuide/quickref-ec2-auto-scaling.md +++ b//AWSCloudFormation/latest/UserGuide/quickref-ec2-auto-scaling.md @@ -5 +5 @@ -Create a single instance Auto Scaling groupCreate an Auto Scaling group with an attached load balancerCreate an Auto Scaling group with notificationsCreate an Auto Scaling group that uses a CreationPolicy and an UpdatePolicyCreate a step scaling policyMixed instances group examplesLaunch configuration examples +Create a single instance Amazon EC2 Auto Scaling groupCreate an Amazon EC2 Auto Scaling group with an attached load balancerCreate an Amazon EC2 Auto Scaling group with notificationsCreate an Amazon EC2 Auto Scaling group that uses a CreationPolicy and an UpdatePolicyCreate a step scaling policyMixed instances group examplesLaunch configuration examples @@ -13 +13 @@ The following examples show different snippets to include in templates for use w - * Create a single instance Auto Scaling group + * Create a single instance Amazon EC2 Auto Scaling group @@ -15 +15 @@ The following examples show different snippets to include in templates for use w - * Create an Auto Scaling group with an attached load balancer + * Create an Amazon EC2 Auto Scaling group with an attached load balancer @@ -17 +17 @@ The following examples show different snippets to include in templates for use w - * Create an Auto Scaling group with notifications + * Create an Amazon EC2 Auto Scaling group with notifications @@ -19 +19 @@ The following examples show different snippets to include in templates for use w - * Create an Auto Scaling group that uses a CreationPolicy and an UpdatePolicy + * Create an Amazon EC2 Auto Scaling group that uses a CreationPolicy and an UpdatePolicy @@ -30 +30 @@ The following examples show different snippets to include in templates for use w -## Create a single instance Auto Scaling group +## Create a single instance Amazon EC2 Auto Scaling group @@ -32 +32 @@ The following examples show different snippets to include in templates for use w -This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-autoscalinggroup.html) resource with a single instance to help you get started. The `VPCZoneIdentifier` property of the Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchTemplate` property references an [`AWS::EC2::LaunchTemplate`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-launchtemplate.html) resource with the logical name `myLaunchTemplate` that is defined elsewhere in your template. +This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-autoscalinggroup.html) resource with a single instance to help you get started. The `VPCZoneIdentifier` property of the Amazon EC2 Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchTemplate` property references an [`AWS::EC2::LaunchTemplate`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-launchtemplate.html) resource with the logical name `myLaunchTemplate` that is defined elsewhere in your template. @@ -77 +77 @@ For examples of launch templates, see [Create launch templates with CloudFormati -## Create an Auto Scaling group with an attached load balancer +## Create an Amazon EC2 Auto Scaling group with an attached load balancer @@ -81 +81 @@ This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.am - 1. The `VPCZoneIdentifier` property specifies the logical names of two [`AWS::EC2::Subnet`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-subnet.html) resources where the Auto Scaling group's EC2 instances will be created: `myPublicSubnet1` and `myPublicSubnet2`. + 1. The `VPCZoneIdentifier` property specifies the logical names of two [`AWS::EC2::Subnet`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-subnet.html) resources where the Amazon EC2 Auto Scaling group's EC2 instances will be created: `myPublicSubnet1` and `myPublicSubnet2`. @@ -85 +85 @@ This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.am - 3. The `TargetGroupARNs` property lists the target groups for an Application Load Balancer or Network Load Balancer used to route traffic to the Auto Scaling group. In this example, one target group is specified, an [`AWS::ElasticLoadBalancingV2::TargetGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-targetgroup.html) resource with the logical name `myTargetGroup`. + 3. The `TargetGroupARNs` property lists the target groups for an Application Load Balancer or Network Load Balancer used to route traffic to the Amazon EC2 Auto Scaling group. In this example, one target group is specified, an [`AWS::ElasticLoadBalancingV2::TargetGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-targetgroup.html) resource with the logical name `myTargetGroup`. @@ -133 +133 @@ This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.am -For a detailed example that creates an Auto Scaling group with a target tracking scaling policy based on the `ALBRequestCountPerTarget` predefined metric for your Application Load Balancer, see the [Examples](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-scalingpolicy.html#aws-resource-autoscaling-scalingpolicy--examples) section in the `AWS::AutoScaling::ScalingPolicy` resource. +For a detailed example that creates an Amazon EC2 Auto Scaling group with a target tracking scaling policy based on the `ALBRequestCountPerTarget` predefined metric for your Application Load Balancer, see the [Examples](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-scalingpolicy.html#aws-resource-autoscaling-scalingpolicy--examples) section in the `AWS::AutoScaling::ScalingPolicy` resource. @@ -135 +135 @@ For a detailed example that creates an Auto Scaling group with a target tracking -## Create an Auto Scaling group with notifications +## Create an Amazon EC2 Auto Scaling group with notifications @@ -139 +139 @@ This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.am -The `VPCZoneIdentifier` property of the Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchTemplate` property references the logical name of an [`AWS::EC2::LaunchTemplate`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-launchtemplate.html) resource declared elsewhere in the same template. +The `VPCZoneIdentifier` property of the Amazon EC2 Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchTemplate` property references the logical name of an [`AWS::EC2::LaunchTemplate`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-launchtemplate.html) resource declared elsewhere in the same template. @@ -205 +205 @@ The `VPCZoneIdentifier` property of the Auto Scaling group specifies a list of e -## Create an Auto Scaling group that uses a `CreationPolicy` and an `UpdatePolicy` +## Create an Amazon EC2 Auto Scaling group that uses a `CreationPolicy` and an `UpdatePolicy` @@ -209 +209 @@ The following example shows how to add `CreationPolicy` and `UpdatePolicy` attri -The sample creation policy prevents the Auto Scaling group from reaching `CREATE_COMPLETE` status until CloudFormation receives `Count` number of success signals when the group is ready. To signal that the Auto Scaling group is ready, a `cfn-signal` helper script added to the launch template's user data (not shown) is run on the instances. If the instances don't send a signal within the specified `Timeout`, CloudFormation assumes that the instances were not created, the resource creation fails, and CloudFormation rolls the stack back. +The sample creation policy prevents the Amazon EC2 Auto Scaling group from reaching `CREATE_COMPLETE` status until CloudFormation receives `Count` number of success signals when the group is ready. To signal that the Amazon EC2 Auto Scaling group is ready, a `cfn-signal` helper script added to the launch template's user data (not shown) is run on the instances. If the instances don't send a signal within the specified `Timeout`, CloudFormation assumes that the instances were not created, the resource creation fails, and CloudFormation rolls the stack back. @@ -211 +211 @@ The sample creation policy prevents the Auto Scaling group from reaching `CREATE -The sample update policy instructs CloudFormation to perform a rolling update using the `AutoScalingRollingUpdate` property. The rolling update makes changes to the Auto Scaling group in small batches (for this example, instance by instance) based on the `MaxBatchSize` and a pause time between batches of updates based on the `PauseTime`. The `MinInstancesInService` attribute specifies the minimum number of instances that must be in service within the Auto Scaling group while CloudFormation updates old instances. +The sample update policy instructs CloudFormation to perform a rolling update using the `AutoScalingRollingUpdate` property. The rolling update makes changes to the Amazon EC2 Auto Scaling group in small batches (for this example, instance by instance) based on the `MaxBatchSize` and a pause time between batches of updates based on the `PauseTime`. The `MinInstancesInService` attribute specifies the minimum number of instances that must be in service within the Amazon EC2 Auto Scaling group while CloudFormation updates old instances. @@ -213 +213 @@ The sample update policy instructs CloudFormation to perform a rolling update us -The `WaitOnResourceSignals` attribute is set to `true`. CloudFormation must receive a signal from each new instance within the specified `PauseTime` before continuing the update. While the stack update is in progress, the following EC2 Auto Scaling processes are suspended: `HealthCheck`, `ReplaceUnhealthy`, `AZRebalance`, `AlarmNotification`, and `ScheduledActions`. Note: Don't suspend the `Launch`, `Terminate`, or `AddToLoadBalancer` (if the Auto Scaling group is being used with Elastic Load Balancing) process types because doing so can prevent the rolling update from functioning properly. +The `WaitOnResourceSignals` attribute is set to `true`. CloudFormation must receive a signal from each new instance within the specified `PauseTime` before continuing the update. While the stack update is in progress, the following EC2 Auto Scaling processes are suspended: `HealthCheck`, `ReplaceUnhealthy`, `AZRebalance`, `AlarmNotification`, and `ScheduledActions`. Note: Don't suspend the `Launch`, `Terminate`, or `AddToLoadBalancer` (if the Amazon EC2 Auto Scaling group is being used with ELB) process types because doing so can prevent the rolling update from functioning properly. @@ -215 +215 @@ The `WaitOnResourceSignals` attribute is set to `true`. CloudFormation must rece -The `VPCZoneIdentifier` property of the Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchTemplate` property references the logical name of an [`AWS::EC2::LaunchTemplate`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-launchtemplate.html) resource declared elsewhere in the same template. +The `VPCZoneIdentifier` property of the Amazon EC2 Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchTemplate` property references the logical name of an [`AWS::EC2::LaunchTemplate`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-launchtemplate.html) resource declared elsewhere in the same template. @@ -305 +305 @@ For more information about the `CreationPolicy` and `UpdatePolicy` attributes, s -This example shows an [`AWS::AutoScaling::ScalingPolicy`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-scalingpolicy.html) resource that scales out the Auto Scaling group using a step scaling policy. The `AdjustmentType` property specifies `ChangeInCapacity`, which means that the `ScalingAdjustment` represents the number of instances to add (if `ScalingAdjustment` is positive) or delete (if it is negative). In this example, `ScalingAdjustment` is 1; therefore, the policy increments the number of EC2 instances in the group by 1 when the alarm threshold is breached. +This example shows an [`AWS::AutoScaling::ScalingPolicy`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-scalingpolicy.html) resource that scales out the Amazon EC2 Auto Scaling group using a step scaling policy. The `AdjustmentType` property specifies `ChangeInCapacity`, which means that the `ScalingAdjustment` represents the number of instances to add (if `ScalingAdjustment` is positive) or delete (if it is negative). In this example, `ScalingAdjustment` is 1; therefore, the policy increments the number of EC2 instances in the group by 1 when the alarm threshold is breached. @@ -389 +389 @@ For more example templates for scaling policies, see the [Examples](https://docs -### Create an Auto Scaling group using attribute-based instance type selection +### Create an Amazon EC2 Auto Scaling group using attribute-based instance type selection @@ -391 +391 @@ For more example templates for scaling policies, see the [Examples](https://docs -This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-autoscalinggroup.html) resource that contains the information to launch a mixed instances group using attribute-based instance type selection. You specify the minimum and maximum values for the `VCpuCount` property and the minimum value for the `MemoryMiB` property. Any instance types used by the Auto Scaling group must match your required instance attributes. +This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-autoscalinggroup.html) resource that contains the information to launch a mixed instances group using attribute-based instance type selection. You specify the minimum and maximum values for the `VCpuCount` property and the minimum value for the `MemoryMiB` property. Any instance types used by the Amazon EC2 Auto Scaling group must match your required instance attributes. @@ -393 +393 @@ This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.am -The `VPCZoneIdentifier` property of the Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchTemplate` property references the logical name of an [`AWS::EC2::LaunchTemplate`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-launchtemplate.html) resource declared elsewhere in the same template. +The `VPCZoneIdentifier` property of the Amazon EC2 Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchTemplate` property references the logical name of an [`AWS::EC2::LaunchTemplate`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-launchtemplate.html) resource declared elsewhere in the same template. @@ -474 +474 @@ The `VPCZoneIdentifier` property of the Auto Scaling group specifies a list of e -This example shows an [`AWS::AutoScaling::LaunchConfiguration`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-launchconfiguration.html) resource for an Auto Scaling group where you specify values for the `ImageId`, `InstanceType`, and `SecurityGroups` properties. The `SecurityGroups` property specifies both the logical name of an [`AWS::EC2::SecurityGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-securitygroup.html) resource that's specified elsewhere in the template, and an existing EC2 security group named `myExistingEC2SecurityGroup`. +This example shows an [`AWS::AutoScaling::LaunchConfiguration`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-launchconfiguration.html) resource for an Amazon EC2 Auto Scaling group where you specify values for the `ImageId`, `InstanceType`, and `SecurityGroups` properties. The `SecurityGroups` property specifies both the logical name of an [`AWS::EC2::SecurityGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-securitygroup.html) resource that's specified elsewhere in the template, and an existing EC2 security group named `myExistingEC2SecurityGroup`. @@ -500 +500 @@ This example shows an [`AWS::AutoScaling::LaunchConfiguration`](https://docs.aws -### Create an Auto Scaling group that uses a launch configuration +### Create an Amazon EC2 Auto Scaling group that uses a launch configuration @@ -502 +502 @@ This example shows an [`AWS::AutoScaling::LaunchConfiguration`](https://docs.aws -This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-autoscalinggroup.html) resource with a single instance. The `VPCZoneIdentifier` property of the Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchConfigurationName` property references an [`AWS::AutoScaling::LaunchConfiguration`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-launchconfiguration.html) resource with the logical name `mySimpleConfig` that is defined in your template. +This example shows an [`AWS::AutoScaling::AutoScalingGroup`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-autoscalinggroup.html) resource with a single instance. The `VPCZoneIdentifier` property of the Amazon EC2 Auto Scaling group specifies a list of existing subnets in three different Availability Zones. You must specify the applicable subnet IDs from your account before you create your stack. The `LaunchConfigurationName` property references an [`AWS::AutoScaling::LaunchConfiguration`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-autoscaling-launchconfiguration.html) resource with the logical name `mySimpleConfig` that is defined in your template.