教程:配置用户数据以通过实例元数据检索目标生命周期状态 - Amazon EC2 Auto Scaling
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

教程:配置用户数据以通过实例元数据检索目标生命周期状态

为生命周期钩子创建自定义操作的一种常见方法是使用 Amazon EC2 Auto Scaling 发送给其他服务(例如 Amazon EventBridge)的通知。但是,您可以避免创建额外的基础设施,方法是使用用户数据脚本将配置实例并完成生命周期操作的代码移动到实例本身中。

以下教程介绍如何开始使用用户数据脚本和实例元数据。您可以使用读取您组中实例的目标周期状态并在实例生命周期的特定阶段执行回调操作以继续启动过程的用户数据脚本来创建基本 Auto Scaling 组配置。

步骤 1:创建具有完成生命周期操作权限的 IAM 角色

使用 Amazon CLI 或 Amazon 开发工具包发送回调以完成生命周期操作时,您必须使用具有完成生命周期操作权限的 IAM 角色。

创建 策略

  1. 打开 IAM 控制台的策略页面,然后选择创建策略

  2. 请选择 JSON 选项卡。

  3. 策略文档框中,将以下策略文档复制并粘贴到框中。将示例文本替换为您的账号和您要创建的 Auto Scaling 组的名称 (TestAutoScalingEvent-group)。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "autoscaling:CompleteLifecycleAction" ], "Resource": "arn:aws:autoscaling:*:123456789012:autoScalingGroup:*:autoScalingGroupName/TestAutoScalingEvent-group" } ] }
  4. 选择 Next: Tags,然后选择 Next:Review

  5. 对于 Name (名称),请输入 TestAutoScalingEvent-policy。选择 Create policy(创建策略)

完成创建策略之后,您可以创建一个使用该策略的角色。

创建 角色

  1. 在左侧的导航窗格中,选择角色

  2. 选择 Create role(创建角色)。

  3. 对于 Select trusted entity(选择可信实体),选择 Amazon service(Amazon 服务)。

  4. 对于您的使用案例,选择 EC2,然后选择 Next(下一步)。

  5. Attach permissions(附加权限)下,选择您创建的策略(TestAutoScalingEvent-policy)。然后选择下一步

  6. Name, review, and create(命名、检查并创建)页面上,对于 Role name(角色名称),输入 TestAutoScalingEvent-role,然后选择 Create role(创建角色)。

步骤 2:创建启动模板并包含 IAM 角色和用户数据脚本

创建用于 Auto Scaling 组的启动模板。包含您创建的 IAM 角色和提供的示例用户数据脚本。

创建启动模板

  1. 打开 Amazon EC2 控制台上的启动模板页面

  2. 选择Create launch template(创建启动模板)。

  3. 对于 Launch template name(启动模板名称),输入 TestAutoScalingEvent-template

  4. Auto Scaling guidance(Auto Scaling 指导)下,选中复选框。

  5. 对于 Application and OS Images (Amazon Machine Image) [应用程序和操作系统镜像(Amazon Machine Image)],请从 Quick Start(快速启动)列表中选择 Amazon Linux 2 (HVM)、SSD Volume Type(SSD 卷类型)、64-bit (x86) [64 位(x86)]。

  6. 对于 Instance type(实例类型),选择一种 Amazon EC2 实例类型(例如“t2.micro”)。

  7. 对于高级详细信息,展开该节以查看字段。

  8. 对于 IAM instance profile(IAM 实例配置文件),选择您 IAM 角色的 IAM 实例配置文件名称(TestAutoScalingEvent-role)。实例配置文件是 IAM 角色的容器,在实例启动时允许 Amazon EC2 将 IAM 角色传递到实例。

    使用 IAM 控制台创建 IAM 角色时,控制台自动创建实例配置文件,按相应的角色为文件命名。

  9. 对于 User data(用户数据),将下面的实例用户数据脚本粘贴到字段。将 group_name 的示例文本替换为您要创建的自动扩缩组的名称,将 region 替换为您希望您的自动扩缩组使用的 Amazon Web Services 区域 区域。

    #!/bin/bash function get_target_state { echo $(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state) } function get_instance_id { echo $(curl -s http://169.254.169.254/latest/meta-data/instance-id) } function complete_lifecycle_action { instance_id=$(get_instance_id) group_name='TestAutoScalingEvent-group' region='us-west-2' echo $instance_id echo $region echo $(aws autoscaling complete-lifecycle-action \ --lifecycle-hook-name TestAutoScalingEvent-hook \ --auto-scaling-group-name $group_name \ --lifecycle-action-result CONTINUE \ --instance-id $instance_id \ --region $region) } function main { while true do target_state=$(get_target_state) if [ \"$target_state\" = \"InService\" ]; then # Change hostname export new_hostname="${group_name}-$instance_id" hostname $new_hostname # Send callback complete_lifecycle_action break fi echo $target_state sleep 5 done } main

    此简单用户数据脚本将执行以下操作:

    • 调用实例元数据以从实例元数据中检索目标生命周期状态和实例 ID

    • 重复检索目标生命周期状态,直到它变为 InService

    • 如果目标生命周期状态为 InService,则将实例的主机名更改为实例 ID 前面加上 Auto Scaling 组名称

    • 通过调用 complete-lifecycle-action CLI 命令向 Amazon EC2 Auto Scaling 发出信号以 CONTINUE EC2 启动过程来发送回调

  10. 选择Create launch template(创建启动模板)。

  11. 在确认页面上,选择 Create Auto Scaling group(创建 Auto Scaling 组)。

注意

有关可用作开发用户数据脚本的其他参考示例,请参阅 Amazon EC2 Auto Scaling 的 GitHub 存储库

步骤 3:创建 Auto Scaling 组

创建启动模板后,创建 Auto Scaling 组。

创建 Auto Scaling 组

  1. Choose launch template or configuration(选择启动模板或配置)页面上,对于 Auto Scaling group name(Auto Scaling 组名称),输入 Auto Scaling 组的名称 (TestAutoScalingEvent-group)。

  2. 选择 Next(下一步)转至 Choose instance launch options(选择实例启动选项)页面。

  3. 对于 Network(网络),选择 VPC。

  4. 对于 Availability Zones and subnets(可用区和子网),请从一个或多个可用区中选择一个或多个子网。

  5. Instance type requirements(实例类型要求)部分中,使用默认设置简化此步骤。(请勿覆盖启动模板。) 在本教程中,您将仅使用启动模板中指定的实例类型启动一个按需型实例。

  6. 在屏幕的底部选择 Skip to review(跳至审核)。

  7. Review(审核)页面中,检查 Auto Scaling 组的详细信息,然后选择 Create Auto Scaling group(创建 Auto Scaling 组)。

步骤 4:添加生命周期钩子

添加生命周期钩子以将实例保持在等待状态,直到您的生命周期操作完成。

添加生命周期挂钩

  1. 打开 Amazon EC2 控制台的自动扩缩组页面

  2. 选中您的 Auto Scaling 组旁边的复选框。

    将在 Auto Scaling 组页面底部打开一个拆分窗格。

  3. 在下方窗格中,在实例管理选项卡的生命周期钩子中,选择创建生命周期钩子

  4. 要定义生命周期挂钩,请执行以下操作:

    1. 对于生命周期钩子名称,请输入 TestAutoScalingEvent-hook

    2. 对于生命周期转换,请选择实例启动

    3. 对于 Heartbeat timeout(检测信号超时),输入 300 以获取等待用户数据脚本回调的秒数。

    4. 对于默认结果,请选择放弃。如果钩子超时而未收到来自您用户数据脚本的回调,Auto Scaling 组将终止新实例。

    5. (可选)将 Notification metadata(通知元数据)留空。

  5. 选择 Create (创建)

步骤 5:测试和验证功能

要测试功能,请通过将 Auto Scaling 组的所需容量增加 1 来更新 Auto Scaling 组。用户数据脚本运行并在实例启动后立即开始检查实例的目标生命周期状态。当目标生命周期状态为 InService 时,脚本会更改主机名并发送回调操作。完成此操作通常仅需要几秒钟时间。

增加您的 Auto Scaling 组的大小

  1. 打开 Amazon EC2 控制台的自动扩缩组页面

  2. 选中您的 Auto Scaling 组旁边的复选框。在下方窗格中查看详细信息,同时仍然可以看到上方窗格的顶部几行。

  3. 在下方窗格中的详细信息选项卡上,选择组详细信息编辑

  4. 对于 Desired capacity (所需容量),将当前值增加 1。

  5. 选择 Update(更新)。启动实例时,上方窗格中的状态列会显示正在更新容量状态。

在增加所需容量后,您可以通过扩缩活动的描述来验证您的实例是否已成功启动且未终止。

查看扩展活动

  1. 返回到 Auto Scaling 组页面并选择您的组。

  2. 活动选项卡上的活动历史记录下,状态列显示您的 Auto Scaling 组是否已成功启动实例。

  3. 如果用户数据脚本失败,则在超时时段过后,您会看到状态为 Canceled 且状态消息为 Instance failed to complete user's Lifecycle Action: Lifecycle Action with token e85eb647-4fe0-4909-b341-a6c42EXAMPLE was abandoned: Lifecycle Action Completed with ABANDON Result 的扩缩活动。

步骤 6:清除

如果您已完成为本教程创建的资源,请使用以下步骤将其删除。

删除生命周期钩子

  1. 打开 Amazon EC2 控制台的自动扩缩组页面

  2. 选中您的 Auto Scaling 组旁边的复选框。

  3. 实例管理选项卡的生命周期钩子中,选择生命周期钩子 (TestAutoScalingEvent-hook)。

  4. 依次选择 Actions(操作)Delete(删除)

  5. 再次选择删除以确认。

要删除启动模板

  1. 打开 Amazon EC2 控制台上的 Launch templates page(启动模板页面)。

  2. 选择启动模板 (TestAutoScalingEvent-template),然后依次选择 Actions(操作)、Delete template(删除模板)。

  3. 在提示确认时,选择 Delete launch template(删除启动模板)。

如果您已完成使用此示例 Auto Scaling 组,请将其删除。您还可以删除您创建的 IAM 角色和权限策略。

要删除 Auto Scaling 组

  1. 打开 Amazon EC2 控制台的自动扩缩组页面

  2. 选中 Auto Scaling 组 (TestAutoScalingEvent-group) 旁边的复选框并选择 Delete(删除)。

  3. 当系统提示进行确认时,选择 Delete(删除)。

    Name(名称)列中的加载图标指示 Auto Scaling 组正在被删除。终止实例并删除组需要几分钟时间。

要删除 IAM 角色

  1. 打开 IAM 控制台的 Roles page(角色页面)。

  2. 选择函数的角色 (TestAutoScalingEvent-role)。

  3. 选择 Delete role(删除角色)。

  4. Delete role(删除角色)对话框中,选择 Yes, delete(是的,删除)。

删除 IAM policy

  1. 打开 IAM 控制台的 Policies(策略)页面

  2. 选择您创建的策略 (TestAutoScalingEvent-policy)。

  3. 选择 Delete policy (删除策略)

  4. Delete policy(删除策略)对话框中,选择 Yes, delete(是的,删除)。