AWS自动扩散热池实例以Stopped状态启动时不执行user-data脚本

问题根源 #

1. User-Data执行时机限制：EC2的user-data脚本默认仅在**实例首次启动（从AMI创建后第一次进入Running状态）**时执行一次。当暖池配置为Stopped模式时，实例流程是：ASG创建实例→进入Running→ASG自动将其停止转入暖池。如果你的脚本依赖ASG正式服务实例的元数据/生命周期事件（比如ASG标签、服务组环境变量），暖池实例此时不属于正式服务实例，相关触发条件不满足，会导致脚本执行失败或未按预期运行；当暖池实例被唤醒转入ASG时，属于重启而非首次启动，user-data默认不会再次执行。
2. 暖池实例的生命周期特殊性：暖池实例处于ASG的预准备状态，默认不会触发ASG的标准生命周期钩子（如autoscaling:EC2_INSTANCE_LAUNCHING）。而Running模式的暖池实例会保持Running状态，创建时的首次启动能完整执行不依赖正式ASG生命周期的user-data，因此能正常运行。

解决方案（对应你提到的CloudFormation实现逻辑） #

你看到的教程应该是用ASG自定义生命周期钩子+EC2系统级停止脚本的组合实现的，核心逻辑如下：

• 用生命周期钩子暂停暖池实例的停止流程，确保脚本执行完成后再转入Stopped状态；
• 在实例首次启动时注册系统级停止触发器，让脚本在实例被停止前自动执行；
• 脚本执行完成后通知ASG钩子完成，允许实例进入暖池。

Terraform核心配置示例 #

1. ASG暖池与生命周期钩子配置：

resource "aws_autoscaling_group" "example" {
  # 你的基础ASG配置（最小/最大实例数、启动模板等）

  warm_pool {
    pool_state = "Stopped"
    max_size   = 3 # 暖池最大实例数
  }

  lifecycle_hook {
    name                   = "warm-pool-launch-hook"
    lifecycle_transition   = "autoscaling:WARM_POOL_INSTANCE_LAUNCHED"
    heartbeat_timeout      = 300 # 脚本执行超时时间（秒）
    default_result         = "CONTINUE" # 超时后默认继续流程
  }
}

2. User-Data脚本（嵌入停止触发器与钩子通知）：

#!/bin/bash
# 1. 注册systemd停止服务，确保实例停止前执行脚本
cat > /etc/systemd/system/warm-pool-pre-stop.service << EOF
[Unit]
Description=Run pre-stop script for warm pool instance
Before=shutdown.target reboot.target halt.target

[Service]
Type=oneshot
ExecStart=/opt/warm-pool-pre-stop.sh
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable warm-pool-pre-stop.service

# 2. 编写你的业务脚本（停止前需要执行的逻辑）
cat > /opt/warm-pool-pre-stop.sh << EOF
#!/bin/bash
# 这里替换为你需要的预执行逻辑，比如初始化配置、下载依赖等
echo "Pre-stop script executed at \$(date)" >> /var/log/warm-pool.log

# 3. 通知ASG生命周期钩子执行完成
INSTANCE_ID=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)
REGION=$(curl -s http://169.254.169.254/latest/meta-data/placement/region)
aws autoscaling complete-lifecycle-action \
  --lifecycle-hook-name warm-pool-launch-hook \
  --auto-scaling-group-name ${ASG_NAME} \
  --lifecycle-action-result CONTINUE \
  --instance-id \$INSTANCE_ID \
  --region \$REGION
EOF

chmod +x /opt/warm-pool-pre-stop.sh

关键说明 #

• 生命周期钩子的作用是暂停实例转入暖池的流程，避免脚本未执行完就被停止；
• 系统级停止服务（systemd）确保实例在被停止时触发业务逻辑，不受user-data执行时机的限制；
• 如果你的脚本不需要严格保证执行完整性，也可以省略生命周期钩子，但钩子能避免因脚本执行超时导致的异常。

内容的提问来源于stack exchange，提问作者Ely