Amazon EC2 Auto Scaling

用户指南

AWS 文档 » Amazon EC2 Auto Scaling » 用户指南 » 扩展 Auto Scaling 组的大小 » Amazon EC2 Auto Scaling 生命周期挂钩

Amazon EC2 Auto Scaling 生命周期挂钩

生命周期挂钩使您能够在 Auto Scaling 组启动或终止实例时通过暂停实例执行自定义操作。当实例被暂停后，它将保持等待状态，直到您使用 complete-lifecycle-action CLI 命令或 CompleteLifecycleAction API 操作完成生命周期操作，或者超时时段（默认为 1 小时）结束。

例如，您新启动的实例已完成其启动序列，一个生命周期挂钩暂停该实例。该实例处于等待状态时，您可以在其上安装或配置软件，确保您的实例在开始接收流量前已完全准备好。有关使用生命周期挂钩的另一个示例是，在发生缩减事件时，终止实例要首先从负载均衡器中取消注册（如果 Auto Scaling 组由 Elastic Load Balancing 使用）。然后，生命周期挂钩会在将实例终止之前将其暂停。当实例处于等待状态时，您可以执行连接到实例并下载日志或其他数据等操作，然后再将该实例完全终止。

每个 Auto Scaling 组均可具有多个生命周期挂钩。但是，每个 Auto Scaling 组的挂钩数存在限制。有关更多信息，请参阅 Amazon EC2 Auto Scaling 限制。

生命周期挂钩的工作方式

在将生命周期挂钩添加到 Auto Scaling 组后，其工作方式如下：

下图阐释了此过程中实例状态之间的过渡：

有关 Auto Scaling 组中实例的完整生命周期的更多信息，请参阅Auto Scaling 生命周期。

使用生命周期挂钩时的注意事项

向 Auto Scaling 组添加生命周期挂钩，使您可以对实例的启动和终止方式进行更多控制。下面是在向 Auto Scaling 组添加生命周期挂钩时为确保组按预期方式继续执行而要考虑的一些事项。

使实例保持等待状态

实例可以在有限的时间里保持等待状态。默认值为 1 小时（3600 秒）。您可以通过以下方式调整该时长：

您可以将实例保持在等待状态的最长时间是 48 小时或检测信号超时的 100 倍（以较小者为准）。

冷却时间和自定义操作

当 Auto Scaling 组启动或终止简单扩展策略引起的实例时，冷却时间生效。冷却时间可帮助确保 Auto Scaling 组只根据需要启动或终止合适数量的实例。

考虑在实例启动时使用包含支持自定义操作的声明周期挂钩的 Auto Scaling 组。当应用程序需求增加时，该组会启动实例以增加容量。由于存在生命周期挂钩，实例会置于 Pending:Wait 状态，这意味着该实例尚无法用于处理流量。当实例进入等待状态时，简单扩展策略引起的扩展操作会暂停。当实例进入 InService 状态时，冷却时间开始。冷却时间过后，所有暂停的扩展操作都会恢复。

运行状况检查宽限期

如果添加一个生命周期挂钩，在生命周期挂钩操作完成并且实例进入 InService 状态后，运行状况检查宽限期才会开始。

生命周期操作结果

生命周期挂钩结束时，结果为 ABANDON 或 CONTINUE。

如果实例正在启动，则 CONTINUE 指示您的操作已成功，并且可将实例投入使用。否则，ABANDON 指示您的自定义操作未成功，并且可终止实例。

如果实例正在终止，则 ABANDON 和 CONTINUE 都允许终止实例。不过，ABANDON 将停止任何剩余操作（例如，其他生命周期挂钩），而 CONTINUE 将允许完成任何其他生命周期挂钩。

Spot 实例

您可以对 Spot 实例使用生命周期挂钩。但是，生命周期挂钩并不禁止在容量不再可用的情况下终止实例。此外，在 Spot 实例终止时，您仍需完成生命周期操作（使用 complete-lifecycle-action 命令或 CompleteLifecycleAction 操作）。

准备通知

您可以配置当实例进入等待状态时的通知，这能让您执行自定义操作。您可以使用 Amazon CloudWatch Events、Amazon SNS 或 Amazon SQS 接收通知。选择您喜好的选项。

或者，如果您拥有在实例启动时配置实例的脚本，则无需在生命周期操作发生时接收通知。如果您尚未这样做，请更新脚本，从实例元数据中检索实例的实例 ID。有关更多信息，请参阅检索实例元数据。

使用 CloudWatch Events 将通知路由到 Lambda

您可以使用 CloudWatch Events 设置一个目标以在生命周期操作发生时调用 Lambda 函数。

使用 CloudWatch Events 设置通知

1. 使用 创建 Lambda 函数 中的步骤创建 Lambda 函数，并记下其 Amazon 资源名称 (ARN)。例如：arn:aws-cn:lambda:region:123456789012:function:my-function。

2. 使用以下 put-rule 命令创建一个与生命周期操作匹配的 CloudWatch Events 规则。

   aws events put-rule --name my-rule --event-pattern file://pattern.json --state ENABLED

   实例启动生命周期操作的 pattern.json 为：

   {
     "source": [ "aws.autoscaling" ],
     "detail-type": [ "EC2 Instance-launch Lifecycle Action" ]
   }

   实例终止生命周期操作的 pattern.json 为：

   {
     "source": [ "aws.autoscaling" ],
     "detail-type": [ "EC2 Instance-terminate Lifecycle Action" ]
   }

3. 使用以下 add-permission 命令为该规则授予调用 Lambda 函数的权限。此命令信任 CloudWatch Events 服务委托人 (events.amazonaws.com)，并将权限范围划定为指定规则。

   aws lambda add-permission --function-name LogScheduledEvent --statement-id my-scheduled-event \
     --action 'lambda:InvokeFunction' --principal events.amazonaws.com --source-arn arn:aws-cn:events:region:123456789012:rule/my-scheduled-rule

4. 使用以下 put-targets 命令创建一个目标，它在执行生命周期操作时调用 Lambda 函数。

   aws events put-targets --rule my-rule --targets Id=1,Arn=arn:aws-cn:lambda:region:123456789012:function:my-function

5. 在遵循以上说明操作后，继续添加生命周期挂钩 作为下一步。

当 Auto Scaling 组响应扩展或收缩事件时，它将实例置于等待状态。当实例处于等待状态时，Lambda 函数将被调用。有关事件数据的更多信息，请参阅 Auto Scaling 事件。

使用 Amazon SNS 接收通知

您可以使用 Amazon SNS 设置通知目标以便在生命周期操作开始时接收通知。

使用 Amazon SNS 设置通知

1. 使用以下 create-topic 命令创建 Amazon SNS 主题。有关更多信息，请参阅Amazon Simple Notification Service 开发人员指南中的创建主题。

   aws sns create-topic --name my-sns-topic

   记下目标的 ARN（例如 arn:aws-cn:sns:region:123456789012:my-sns-topic）。

2. 为 Amazon EC2 Auto Scaling 创建服务角色（或代入角色），您可以为其授予访问通知目标的权限。

   要创建 IAM 角色并允许 Amazon EC2 Auto Scaling 担任该角色

   1. 通过以下网址打开 IAM 控制台：https://console.amazonaws.cn/iam/。

   2. 在导航窗格中，选择 Roles 和 Create new role。

   3. 在选择受信任实体的类型下，选择 AWS 服务。

   4. 在选择将使用此角色的服务下，选择 EC2 Auto Scaling。

   5. 在选择您的使用案例下，选择 EC2 Auto Scaling Notification Access (EC2 Auto Scaling 通知访问)，然后选择 Next:Permissions (下一步：权限)。

   6. 选择 Next: Tags (下一步：标签)，（可选）通过附加密钥值对为角色添加元数据标签，然后选择 Next: Review (下一步：审核)。

   7. 在审核页面上，键入角色的名称（例如，my-notification-role），然后选择创建角色。

   8. 在角色页面中，选择刚刚创建的角色以打开摘要页面。记录角色 ARN。例如：arn:aws-cn:iam::123456789012:role/my-notification-role。您将在下一步中创建生命周期挂钩时指定角色 ARN。

3. 在遵循以上说明操作后，继续添加生命周期挂钩 作为下一步。

当 Auto Scaling 组响应扩展或收缩事件时，它将实例置于等待状态。当实例处于等待状态时，将向通知目标发布消息。消息包含以下事件数据：

例如：

Service: AWS Auto Scaling
Time: 2019-04-30T20:42:11.305Z
RequestId: 18b2ec17-3e9b-4c15-8024-ff2e8ce8786a
LifecycleActionToken: 71514b9d-6a40-4b26-8523-05e7ee35fa40
AccountId: 123456789012
AutoScalingGroupName: my-asg
LifecycleHookName: my-hook
EC2InstanceId: i-0598c7d356eba48d7
LifecycleTransition: autoscaling:EC2_INSTANCE_LAUNCHING
NotificationMetadata: null

使用 Amazon SQS 接收通知

您可以使用 Amazon SQS 设置通知目标以便在生命周期操作开始时接收通知。

使用 Amazon SQS 设置通知

1. 使用 Amazon SQS 创建目标。有关更多信息，请参阅 Amazon Simple Queue Service 开发人员指南中的 Amazon SQS 入门。记下目标的 ARN（例如 arn:aws-cn:sqs:region:123456789012:my-sqs-queue）。

2. 为 Amazon EC2 Auto Scaling 创建服务角色（或代入 角色），您可以为其授予访问通知目标的权限。

   要创建 IAM 角色并允许 Amazon EC2 Auto Scaling 担任该角色

   1. 通过以下网址打开 IAM 控制台：https://console.amazonaws.cn/iam/。

   2. 在导航窗格中，选择 Roles 和 Create new role。

   3. 在选择受信任实体的类型下，选择 AWS 服务。

   4. 在选择将使用此角色的服务下，选择 EC2 Auto Scaling。

   5. 在选择您的使用案例下，选择 EC2 Auto Scaling Notification Access (EC2 Auto Scaling 通知访问)，然后选择 Next:Permissions (下一步：权限)。

   6. 选择 Next: Tags (下一步：标签)，（可选）通过附加密钥值对为角色添加元数据标签，然后选择 Next: Review (下一步：审核)。

   7. 在审核页面上，键入角色的名称（例如，my-notification-role），然后选择创建角色。

   8. 在角色页面中，选择刚刚创建的角色以打开摘要页面。记录角色 ARN。例如：arn:aws-cn:iam::123456789012:role/my-notification-role。您将在下一步中创建生命周期挂钩时指定角色 ARN。

3. 在遵循以上说明操作后，继续添加生命周期挂钩 作为下一步。

当 Auto Scaling 组响应扩展或收缩事件时，它将实例置于等待状态。当实例处于等待状态时，将向通知目标发布消息。

添加生命周期挂钩

您可以使用 put-lifecycle-hook 命令创建生命周期挂钩。

要执行扩展操作，请使用以下命令。

aws autoscaling put-lifecycle-hook --lifecycle-hook-name my-hook --auto-scaling-group-name my-asg \
  --lifecycle-transition autoscaling:EC2_INSTANCE_LAUNCHING

要执行缩减操作，请使用以下命令。

aws autoscaling put-lifecycle-hook --lifecycle-hook-name my-hook --auto-scaling-group-name my-asg \
  --lifecycle-transition autoscaling:EC2_INSTANCE_TERMINATING

要使用 Amazon SNS 或 Amazon SQS 接收通知，您必须指定其他选项。如果您已按照前面的过程操作，已创建了通知目标和 IAM 角色。有关更多信息，请参阅 准备通知。

例如，添加以下选项可将 SNS 主题指定为通知目标。

--notification-target-arn arn:aws-cn:sns:region:123456789012:my-sns-topic --role-arn arn:aws-cn:iam::123456789012:role/my-notification-role

该主题将使用以下键/值对接收测试通知。

"Event": "autoscaling:TEST_NOTIFICATION"

完成生命周期挂钩

当 Auto Scaling 组响应扩展或缩减事件时，它会将实例置于等待状态并发送任意通知。在您完成生命周期挂钩后，它会继续启动或终止过程。

完成生命周期挂钩

1. 当实例处于等待状态时，您可以执行自定义操作。有关如何创建通知的信息，请参阅准备通知。

2. 如果需要更多时间以完成自定义操作，请使用 record-lifecycle-action-heartbeat 命令重新开始超时时段，并将实例保持为等待状态。您可以指定在上一步中接收的生命周期操作令牌，如以下命令所示。

   aws autoscaling record-lifecycle-action-heartbeat --lifecycle-hook-name my-launch-hook \
     --auto-scaling-group-name my-asg --lifecycle-action-token bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635

   或者，可以指定在上一步中接收的实例的 ID，如以下命令所示。

   aws autoscaling record-lifecycle-action-heartbeat --lifecycle-hook-name my-launch-hook \
     --auto-scaling-group-name my-asg --instance-id i-1a2b3c4d

3. 如果在超时时段结束前完成自定义操作，请使用 complete-lifecycle-action 命令，以便 Auto Scaling 组可以继续启动或终止实例。您可以指定生命周期操作令牌，如以下命令所示。

   aws autoscaling complete-lifecycle-action --lifecycle-action-result CONTINUE \
     --lifecycle-hook-name my-launch-hook --auto-scaling-group-name my-asg \
     --lifecycle-action-token bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635

   或者，您可以指定实例的 ID，如以下命令所示。

   aws autoscaling complete-lifecycle-action --lifecycle-action-result CONTINUE \
     --instance-id i-1a2b3c4d --lifecycle-hook-name my-launch-hook \
     --auto-scaling-group-name my-asg

测试通知

要为启动事件生成通知，请通过将 Auto Scaling 组的所需容量增加 1 来更新 Auto Scaling 组。您将在实例启动后的几分钟内收到通知。

更改所需容量（控制台）

1. 打开 Amazon EC2 控制台 https://console.amazonaws.cn/ec2/。

2. 在导航窗格上的 Auto Scaling 下，选择 Auto Scaling 组。

3. 选择您的 Auto Scaling 组。

4. 在 Details 选项卡上，选择 Edit。

5. 对于 Desired，将当前值增加 1。如果此值超过 Max，还必须将 Max 的值增加 1。

6. 选择保存。

7. 在数分钟后，您将收到事件的通知。如果您不需要您为此测试启动的其他实例，则可以将 Desired 减少 1。在数分钟后，您将收到事件的通知。

本页内容：

• 生命周期挂钩的工作方式
• 使用生命周期挂钩时的注意事项
• 准备通知
• 添加生命周期挂钩
• 完成生命周期挂钩
• 测试通知