AWS AmazonECS documentation change
Summary
Updated terminology from 'Auto Scaling group' to 'Amazon EC2 Auto Scaling group' throughout the document for consistency and clarity. No functional changes to scaling behavior.
Security assessment
Changes are purely terminological updates without any security implications. No vulnerabilities, security features, or incident responses are mentioned or modified.
Diff
diff --git a/AmazonECS/latest/developerguide/cluster-auto-scaling.md b/AmazonECS/latest/developerguide/cluster-auto-scaling.md index d45be6f2a..aa7d56a30 100644 --- a//AmazonECS/latest/developerguide/cluster-auto-scaling.md +++ b//AmazonECS/latest/developerguide/cluster-auto-scaling.md @@ -7 +7 @@ -Amazon ECS can manage the scaling of Amazon EC2 instances that are registered to your cluster. This is referred to as Amazon ECS _cluster auto scaling_. You turn on managed scaling when you create the Amazon ECS Auto Scaling group capacity provider. Then, you set a target percentage (the `targetCapacity`) for the instance utilization in this Auto Scaling group. Amazon ECS creates two custom CloudWatch metrics and a target tracking scaling policy for your Auto Scaling group. Amazon ECS then manages the scale-in and scale-out actions based on the resource utilization that your tasks use. +Amazon ECS can manage the scaling of Amazon EC2 instances that are registered to your cluster. This is referred to as Amazon ECS _cluster auto scaling_. You turn on managed scaling when you create the Amazon ECS Amazon EC2 Auto Scaling group capacity provider. Then, you set a target percentage (the `targetCapacity`) for the instance utilization in this Amazon EC2 Auto Scaling group. Amazon ECS creates two custom CloudWatch metrics and a target tracking scaling policy for your Amazon EC2 Auto Scaling group. Amazon ECS then manages the scale-in and scale-out actions based on the resource utilization that your tasks use. @@ -9 +9 @@ Amazon ECS can manage the scaling of Amazon EC2 instances that are registered to -For each Auto Scaling group capacity provider that's associated with a cluster, Amazon ECS creates and manages the following resources: +For each Amazon EC2 Auto Scaling group capacity provider that's associated with a cluster, Amazon ECS creates and manages the following resources: @@ -19 +19 @@ For each Auto Scaling group capacity provider that's associated with a cluster, -Amazon ECS creates the target tracking scaling policy and attaches it to the Auto Scaling group. To update the target tracking scaling policy, update the capacity provider managed scaling settings, rather than updating the scaling policy directly. +Amazon ECS creates the target tracking scaling policy and attaches it to the Amazon EC2 Auto Scaling group. To update the target tracking scaling policy, update the capacity provider managed scaling settings, rather than updating the scaling policy directly. @@ -33 +33 @@ The percent of container instances in use for a specific capacity provider. Amaz -Amazon ECS sets the `CapacityProviderReservation` value to a number between 0-100. Amazon ECS uses the following formula to represent the ratio of how much capacity remains in the Auto Scaling group. Then, Amazon ECS publishes the metric to CloudWatch. For more information about how the metric is calculated, see [ Deep Dive on Amazon ECS Cluster Auto Scaling](https://aws.amazon.com/blogs/containers/deep-dive-on-amazon-ecs-cluster-auto-scaling/). +Amazon ECS sets the `CapacityProviderReservation` value to a number between 0-100. Amazon ECS uses the following formula to represent the ratio of how much capacity remains in the Amazon EC2 Auto Scaling group. Then, Amazon ECS publishes the metric to CloudWatch. For more information about how the metric is calculated, see [ Deep Dive on Amazon ECS Cluster Auto Scaling](https://aws.amazon.com/blogs/containers/deep-dive-on-amazon-ecs-cluster-auto-scaling/). @@ -41 +41 @@ Amazon ECS sets the `CapacityProviderReservation` value to a number between 0-10 -The amount of capacity for the Auto Scaling group. This metric isn't published to CloudWatch. +The amount of capacity for the Amazon EC2 Auto Scaling group. This metric isn't published to CloudWatch. @@ -48 +48 @@ Amazon ECS publishes the `CapacityProviderReservation` metric to CloudWatch in t -The Auto Scaling group doesn't need to scale in or scale out. The target utilization percentage has been reached. +The Amazon EC2 Auto Scaling group doesn't need to scale in or scale out. The target utilization percentage has been reached. @@ -53 +53 @@ The Auto Scaling group doesn't need to scale in or scale out. The target utiliza -There are more tasks using a higher percentage of the capacity than your `targetCapacity` percentage. The increased value of the `CapacityProviderReservation` metric causes the associated CloudWatch alarm to act. This alarm updates the `DesiredCapacity` value for the Auto Scaling group. The Auto Scaling group uses this value to launch EC2 instances, and then register them with the cluster. +There are more tasks using a higher percentage of the capacity than your `targetCapacity` percentage. The increased value of the `CapacityProviderReservation` metric causes the associated CloudWatch alarm to act. This alarm updates the `DesiredCapacity` value for the Amazon EC2 Auto Scaling group. The Amazon EC2 Auto Scaling group uses this value to launch EC2 instances, and then register them with the cluster. @@ -60 +60 @@ When the `targetCapacity` is the default value of 100 %, the new tasks are in th -There are less tasks using a lower percentage of the capacity than your `targetCapacity` percentage and there is at least one instance that can be terminated. The decreased value of the `CapacityProviderReservation` metric causes the associated CloudWatch alarm to act. This alarm updates the `DesiredCapacity` value for the Auto Scaling group. The Auto Scaling group uses this value to terminate EC2 container instances, and then deregister them from the cluster. +There are less tasks using a lower percentage of the capacity than your `targetCapacity` percentage and there is at least one instance that can be terminated. The decreased value of the `CapacityProviderReservation` metric causes the associated CloudWatch alarm to act. This alarm updates the `DesiredCapacity` value for the Amazon EC2 Auto Scaling group. The Amazon EC2 Auto Scaling group uses this value to terminate EC2 container instances, and then deregister them from the cluster. @@ -62 +62 @@ There are less tasks using a lower percentage of the capacity than your `targetC -The Auto Scaling group follows the group termination policy to determine which instances it terminates first during scale-in events. Additionally it avoids instances with the instance scale-in protection setting turned on. Cluster auto scaling can manage which instances have the instance scale-in protection setting if you turn on managed termination protection. For more information about managed termination protection, see [Control the instances Amazon ECS terminates](./managed-termination-protection.html). For more information about how Auto Scaling groups terminate instances, see [Control which Auto Scaling instances terminate during scale in](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-instance-protection.html) in the _Amazon EC2 Auto Scaling User Guide_. +The Amazon EC2 Auto Scaling group follows the group termination policy to determine which instances it terminates first during scale-in events. Additionally it avoids instances with the instance scale-in protection setting turned on. Cluster auto scaling can manage which instances have the instance scale-in protection setting if you turn on managed termination protection. For more information about managed termination protection, see [Control the instances Amazon ECS terminates](./managed-termination-protection.html). For more information about how Amazon EC2 Auto Scaling groups terminate instances, see [Control which Amazon EC2 Auto Scaling instances terminate during scale in](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-instance-protection.html) in the _Amazon EC2 Auto Scaling User Guide_. @@ -66 +66 @@ Consider the following when using cluster auto scaling: - * Don't change or manage the desired capacity for the Auto Scaling group that's associated with a capacity provider with any scaling policies other than the one Amazon ECS manages. + * Don't change or manage the desired capacity for the Amazon EC2 Auto Scaling group that's associated with a capacity provider with any scaling policies other than the one Amazon ECS manages. @@ -72 +72 @@ Consider the following when using cluster auto scaling: - * When using capacity providers with Auto Scaling groups, the user, group, or role that creates the capacity providers requires the `autoscaling:CreateOrUpdateTags` permission. This is because Amazon ECS adds a tag to the Auto Scaling group when it associates it with the capacity provider. + * When using capacity providers with Amazon EC2 Auto Scaling groups, the user, group, or role that creates the capacity providers requires the `autoscaling:CreateOrUpdateTags` permission. This is because Amazon ECS adds a tag to the Amazon EC2 Auto Scaling group when it associates it with the capacity provider. @@ -76 +76 @@ Consider the following when using cluster auto scaling: -Make sure any tooling that you use doesn't remove the `AmazonECSManaged` tag from the Auto Scaling group. If this tag is removed, Amazon ECS can't manage the scaling. +Make sure any tooling that you use doesn't remove the `AmazonECSManaged` tag from the Amazon EC2 Auto Scaling group. If this tag is removed, Amazon ECS can't manage the scaling. @@ -80 +80 @@ Make sure any tooling that you use doesn't remove the `AmazonECSManaged` tag fro - * When Auto Scaling (managed scaling) is turned on, a capacity provider can only be connected to one cluster at the same time. If your capacity provider has managed scaling turned off, you can associate it with multiple clusters. + * When Amazon EC2 Auto Scaling (managed scaling) is turned on, a capacity provider can only be connected to one cluster at the same time. If your capacity provider has managed scaling turned off, you can associate it with multiple clusters. @@ -95 +95 @@ You can turn on cluster auto scaling by using the Console or the AWS CLI. -When you create a cluster that uses EC2 capacity providers using the console, Amazon ECS creates an Auto Scaling group on your behalf and sets the target capacity. For more information, see [Creating an Amazon ECS cluster for Amazon EC2 workloads](./create-ec2-cluster-console-v2.html). +When you create a cluster that uses EC2 capacity providers using the console, Amazon ECS creates an Amazon EC2 Auto Scaling group on your behalf and sets the target capacity. For more information, see [Creating an Amazon ECS cluster for Amazon EC2 workloads](./create-ec2-cluster-console-v2.html). @@ -97 +97 @@ When you create a cluster that uses EC2 capacity providers using the console, Am -You can also create an Auto Scaling group, and then assign it to a cluster. For more information, see [Updating an Amazon ECS capacity provider](./update-capacity-provider-console-v2.html). +You can also create an Amazon EC2 Auto Scaling group, and then assign it to a cluster. For more information, see [Updating an Amazon ECS capacity provider](./update-capacity-provider-console-v2.html). @@ -101 +101 @@ When you use the AWS CLI, after you create the cluster - 1. Before you create the capacity provider, you need to create an Auto Scaling group. For more information, see[ Auto Scaling groups](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) in the _Amazon EC2 Auto Scaling User Guide_. + 1. Before you create the capacity provider, you need to create an Amazon EC2 Auto Scaling group. For more information, see[ Amazon EC2 Auto Scaling groups](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) in the _Amazon EC2 Amazon EC2 Auto Scaling User Guide_.