AWS AmazonECS documentation change
Summary
Updated terminology from 'Auto Scaling group' to 'Amazon EC2 Auto Scaling group' throughout the document for consistency. Added clarification about Spot Instance draining redundancy when using managed instance draining.
Security assessment
The changes are purely terminological updates to align with AWS service naming conventions. No security vulnerabilities, exploits, or weaknesses are mentioned. The reference to 'security mandates' in compliance contexts is general operational guidance, not evidence of a specific security issue.
Diff
diff --git a/AmazonECS/latest/developerguide/managed-instance-draining.md b/AmazonECS/latest/developerguide/managed-instance-draining.md index 6a91c9561..2059afa34 100644 --- a//AmazonECS/latest/developerguide/managed-instance-draining.md +++ b//AmazonECS/latest/developerguide/managed-instance-draining.md @@ -11 +11 @@ Managed instance draining facilitates graceful termination of Amazon EC2 instanc -Amazon ECS managed instance draining works with Auto Scaling group instance replacements. Based on instance refresh and maximum instance lifetime, customers can ensure that they stay compliant with the latest OS and security mandates for their capacity. +Amazon ECS managed instance draining works with Amazon EC2 Auto Scaling group instance replacements. Based on instance refresh and maximum instance lifetime, customers can ensure that they stay compliant with the latest OS and security mandates for their capacity. @@ -13 +13 @@ Amazon ECS managed instance draining works with Auto Scaling group instance repl -Managed instance draining can only be used with Amazon ECS capacity providers. You can turn on managed instance draining when you create or update your Auto Scaling group capacity providers using the Amazon ECS console, AWS CLI, or SDK. +Managed instance draining can only be used with Amazon ECS capacity providers. You can turn on managed instance draining when you create or update your Amazon EC2 Auto Scaling group capacity providers using the Amazon ECS console, AWS CLI, or SDK. @@ -17 +17 @@ The following events are covered by Amazon ECS managed instance draining. - * [Auto Scaling group instance refresh](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html) ‐ Use instance refresh to perform rolling replacement of your Amazon EC2 instances in your Auto Scaling group instead of manually doing it in batches. This is useful when you need to replace a large number of instances. An instance refresh is initiated through the Amazon EC2 console or the `StartInstanceRefresh` API. Make sure you select `Replace` for Scale-in protection when calling `StartInstanceRefresh` if you're using managed termination protection. + * [Amazon EC2 Auto Scaling group instance refresh](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html) ‐ Use instance refresh to perform rolling replacement of your Amazon EC2 instances in your Amazon EC2 Auto Scaling group instead of manually doing it in batches. This is useful when you need to replace a large number of instances. An instance refresh is initiated through the Amazon EC2 console or the `StartInstanceRefresh` API. Make sure you select `Replace` for Scale-in protection when calling `StartInstanceRefresh` if you're using managed termination protection. @@ -19 +19 @@ The following events are covered by Amazon ECS managed instance draining. - * [Maximum instance lifetime](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-max-instance-lifetime.html) ‐ You can define a maximum lifetime when it comes to replacing Auto Scaling group instances. This is helpful for scheduling replacement instances based on internal security policies or compliance. + * [Maximum instance lifetime](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-max-instance-lifetime.html) ‐ You can define a maximum lifetime when it comes to replacing Amazon EC2 Auto Scaling group instances. This is helpful for scheduling replacement instances based on internal security policies or compliance. @@ -21 +21 @@ The following events are covered by Amazon ECS managed instance draining. - * Auto Scaling group scale-in ‐ Based on scaling policies and scheduled scaling actions, Auto Scaling group supports automatic scaling of instances. By using an Auto Scaling group as an Amazon ECS capacity provider, you can scale-in Auto Scaling group instances when no tasks are running in them. + * Amazon EC2 Auto Scaling group scale-in ‐ Based on scaling policies and scheduled scaling actions, Amazon EC2 Auto Scaling group supports automatic scaling of instances. By using an Amazon EC2 Auto Scaling group as an Amazon ECS capacity provider, you can scale-in Amazon EC2 Auto Scaling group instances when no tasks are running in them. @@ -23 +23 @@ The following events are covered by Amazon ECS managed instance draining. - * [Auto Scaling group health checks](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-health-checks.html) ‐ Auto Scaling group supports many health checks to manage termination of unhealthy instances. + * [Amazon EC2 Auto Scaling group health checks](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-health-checks.html) ‐ Amazon EC2 Auto Scaling group supports many health checks to manage termination of unhealthy instances. @@ -27 +27 @@ The following events are covered by Amazon ECS managed instance draining. - * [Spot capacity rebalancing](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-interruptions.html) ‐ The Auto Scaling group tries to proactively replace Spot Instances that have a higher risk of interruption based on Amazon EC2 capacity rebalance notice. The Auto Scaling group terminates the old instance when the replacement is launched and healthy. Amazon ECS managed instance draining drains the Spot Instance the same way it drains a non-Spot Instance. + * [Spot capacity rebalancing](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-interruptions.html) ‐ The Amazon EC2 Auto Scaling group tries to proactively replace Spot Instances that have a higher risk of interruption based on Amazon EC2 capacity rebalance notice. The Amazon EC2 Auto Scaling group terminates the old instance when the replacement is launched and healthy. Amazon ECS managed instance draining drains the Spot Instance the same way it drains a non-Spot Instance. @@ -34 +34 @@ The following events are covered by Amazon ECS managed instance draining. -###### Amazon EC2 Auto Scaling lifecycle hooks with managed instance draining +###### Amazon EC2 Amazon EC2 Auto Scaling lifecycle hooks with managed instance draining @@ -36 +36 @@ The following events are covered by Amazon ECS managed instance draining. -Auto Scaling group lifecycle hooks enable customer to create solutions that are triggered by certain events in the instance lifecycle and perform a custom action when that certain event occurs. An Auto Scaling group allows for up to 50 hooks. Multiple termination hooks can exist and are performed in parallel, and Auto Scaling group waits for all hooks to finish before terminating an instance. +Amazon EC2 Auto Scaling group lifecycle hooks enable customer to create solutions that are triggered by certain events in the instance lifecycle and perform a custom action when that certain event occurs. An Amazon EC2 Auto Scaling group allows for up to 50 hooks. Multiple termination hooks can exist and are performed in parallel, and Amazon EC2 Auto Scaling group waits for all hooks to finish before terminating an instance. @@ -40 +40 @@ In addition to the Amazon ECS-managed hook termination, you can also configure y -If you've already configured an Auto Scaling group termination lifecycle hook and also enabled Amazon ECS managed instance draining, both lifecycle hooks are performed. The relative timings, however, are not guaranteed. Lifecycle hooks have a `default action` setting to specify the action to take when timeout elapses. In case of failures we recommend using `continue` as the default result in your custom hook. This ensures other hooks, particularly the Amazon ECS managed hooks, aren't impacted by any errors in your custom lifecycle hook. The alternative result of `abandon` causes all other hooks to be skipped and should be avoided. For more information about Auto Scaling group lifecycle hooks see [Amazon EC2 Auto Scaling lifecycle hooks](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) in the _Amazon EC2_ Auto Scaling User Guide. +If you've already configured an Amazon EC2 Auto Scaling group termination lifecycle hook and also enabled Amazon ECS managed instance draining, both lifecycle hooks are performed. The relative timings, however, are not guaranteed. Lifecycle hooks have a `default action` setting to specify the action to take when timeout elapses. In case of failures we recommend using `continue` as the default result in your custom hook. This ensures other hooks, particularly the Amazon ECS managed hooks, aren't impacted by any errors in your custom lifecycle hook. The alternative result of `abandon` causes all other hooks to be skipped and should be avoided. For more information about Amazon EC2 Auto Scaling group lifecycle hooks see [Amazon EC2 Amazon EC2 Auto Scaling lifecycle hooks](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html) in the _Amazon EC2_ Amazon EC2 Auto Scaling User Guide. @@ -61 +61 @@ Disabled | Disabled | Amazon EC2 instances can be scaled-in or terminated at any -With Spot Instance draining, you can set an environment variable `ECS_ENABLE_SPOT_INSTANCE_DRAINING` on the Amazon ECS agent which enables Amazon ECS to place an instance in the draining status in response to the two-minute Spot interruption. Amazon ECS managed instance draining facilitates graceful shutdown of Amazon EC2 instances undergoing termination due to many reasons, not just Spot interruption. For instance, you can use Amazon EC2 Auto Scaling capacity rebalancing to proactively replace Spot Instance at elevated risk of interruption, and managed instance draining performs graceful shutdown of Spot Instance being replaced. When you use managed instance draining, you don't need to enable Spot instance draining separately, so `ECS_ENABLE_SPOT_INSTANCE_DRAINING` in Auto Scaling group user data is redundant. For more information about Spot Instance draining, see [Spot Instances](./create-capacity.html#container-instance-spot). +With Spot Instance draining, you can set an environment variable `ECS_ENABLE_SPOT_INSTANCE_DRAINING` on the Amazon ECS agent which enables Amazon ECS to place an instance in the draining status in response to the two-minute Spot interruption. Amazon ECS managed instance draining facilitates graceful shutdown of Amazon EC2 instances undergoing termination due to many reasons, not just Spot interruption. For instance, you can use Amazon EC2 Amazon EC2 Auto Scaling capacity rebalancing to proactively replace Spot Instance at elevated risk of interruption, and managed instance draining performs graceful shutdown of Spot Instance being replaced. When you use managed instance draining, you don't need to enable Spot instance draining separately, so `ECS_ENABLE_SPOT_INSTANCE_DRAINING` in Amazon EC2 Auto Scaling group user data is redundant. For more information about Spot Instance draining, see [Spot Instances](./create-capacity.html#container-instance-spot). @@ -67 +67 @@ Amazon ECS managed instance draining events are published to Amazon EventBridge, - * Amazon EC2 Auto Scaling sends an event to EventBridge when a lifecycle hook is invoked. + * Amazon EC2 Amazon EC2 Auto Scaling sends an event to EventBridge when a lifecycle hook is invoked.