Auto ScalingライフサイクルフックによるAWSプロセス監視設計｜put-lifecycle-hookと終了処理構成

この記事のポイント

・ aws autoscaling put-lifecycle-hookでTerminatingフックを作成できる
・ heartbeat-timeoutでドレインの猶予時間を秒単位で指定する
・ ss -tnで確立済み接続数を確認してからcomplete-lifecycle-actionを呼ぶ
・ IAMロールにCompleteLifecycleAction権限がないとエラーになる

# Terminatingライフサイクルフックを作成する
aws autoscaling put-lifecycle-hook \
  --lifecycle-hook-name drain-hook \
  --auto-scaling-group-name my-asg \
  --lifecycle-transition autoscaling:EC2_INSTANCE_TERMINATING \
  --heartbeat-timeout 300 \
  --default-result CONTINUE

# ライフサイクルフックの一覧を取得する
aws autoscaling describe-lifecycle-hooks \
  --auto-scaling-group-name my-asg

{
    "LifecycleHooks": [
        {
            "LifecycleHookName": "drain-hook",
            "AutoScalingGroupName": "my-asg",
            "LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING",
            "HeartbeatTimeout": 300,
            "GlobalTimeout": 7200,
            "DefaultResult": "CONTINUE"
        }
    ]
}

# SQSキューを通知先に指定する
aws autoscaling put-lifecycle-hook \
  --lifecycle-hook-name drain-hook \
  --auto-scaling-group-name my-asg \
  --lifecycle-transition autoscaling:EC2_INSTANCE_TERMINATING \
  --heartbeat-timeout 300 \
  --default-result CONTINUE \
  --notification-target-arn arn:aws:sqs:ap-northeast-1:123456789012:lifecycle-queue \
  --role-arn arn:aws:iam::123456789012:role/AutoScalingNotificationRole

#!/bin/bash
# ライフサイクルフック用ドレインスクリプト
# 保存先例: /usr/local/bin/lifecycle-drain.sh

HOOK_NAME="drain-hook"
ASG_NAME="my-asg"
INSTANCE_ID=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)
MAX_WAIT=240
ELAPSED=0

# 確立済みのTCP接続数を確認する（最大MAX_WAIT秒待機する）
while [ "$ELAPSED" -lt "$MAX_WAIT" ]; do
  CONN=$(ss -tn state established | grep -E ':80|:443' | wc -l)
  if [ "$CONN" -eq 0 ]; then
    break
  fi
  sleep 5
  ELAPSED=$((ELAPSED + 5))
done

# ライフサイクルアクションを完了する
aws autoscaling complete-lifecycle-action \
  --lifecycle-hook-name "$HOOK_NAME" \
  --auto-scaling-group-name "$ASG_NAME" \
  --lifecycle-action-result CONTINUE \
  --instance-id "$INSTANCE_ID"

# CONTINUE: インスタンス終了を続行する
aws autoscaling complete-lifecycle-action \
  --lifecycle-hook-name drain-hook \
  --auto-scaling-group-name my-asg \
  --lifecycle-action-result CONTINUE \
  --instance-id i-0abc12345678defgh

# ABANDON: ライフサイクルアクションを中断する（緊急停止やデバッグ時に使う）
aws autoscaling complete-lifecycle-action \
  --lifecycle-hook-name drain-hook \
  --auto-scaling-group-name my-asg \
  --lifecycle-action-result ABANDON \
  --instance-id i-0abc12345678defgh

# ハートビートを延長する（GlobalTimeoutまで繰り返し延長できる）
aws autoscaling record-lifecycle-action-heartbeat \
  --lifecycle-hook-name drain-hook \
  --auto-scaling-group-name my-asg \
  --instance-id i-0abc12345678defgh