ライフサイクルフックを追加する

Auto Scaling インスタンスを待機状態にしてカスタムアクションを実行するために、Auto Scaling グループにライフサイクルフックを追加できます。カスタムアクションは、インスタンスの起動時または終了前に実行されます。インスタンスは、ライフサイクルアクションが完了するまで、またはタイムアウト期間が終了するまで待機状態のままになります。

から Auto Scaling グループを作成すると AWS Management Console、そのグループに 1 つ以上のライフサイクルフックを追加でき、合計で最大 50 個のライフサイクルフックを追加できます。、、または SDK を使用して AWS CLI AWS CloudFormation、Auto Scaling グループの作成時にライフサイクルフックを追加することもできます。

デフォルトでは、コンソールにライフサイクルフックを追加すると、Amazon EC2 Auto Scaling はライフサイクルイベント通知を Amazon に送信します EventBridge。 EventBridge またはユーザーデータスクリプトを使用することがベストプラクティスとして推奨されます。Amazon SNS または Amazon SQS に直接通知を送信するライフサイクルフックを作成するには、put-lifecycle-hookこのトピックの例に示すようにコマンドを使用できます。

ライフサイクルフックを追加する (コンソール)

Auto Scaling グループにライフサイクル フックを追加するには、次の手順に従います。スケールアウト (インスタンスの起動) とスケールイン (インスタンスの終了またはウォーム プールへの復帰) のためのライフサイクルフックを追加するには、2 つの個別のフックを作成する必要があります。

作業を開始する前に、「ライフサイクルフックを Auto Scaling グループに追加するための準備」で説明されているように必要に応じてカスタムアクションがセットアップされていることを確認してください。

スケールアウト用のライフサイクルフックを追加するには

1. https://console.aws.amazon.com/ec2/ でAmazon EC2 コンソールを開き、ナビゲーションペインで [Auto Scaling グループ] を選択します。

2. Auto Scaling グループの横にあるチェックボックスを選択します。ページの下部にスプリットペインが開きます。

3. [Instance management (インスタンス管理)] タブの [Lifecycle hooks (ライフサイクルフック)] で、[Create lifecycle hook (ライフサイクルフックを作成)] を選択します。

4. スケールアウト (インスタンスが起動) のライフサイクルフックを定義するには、以下を実行してください。

   1. [Lifecycle hook name (ライフサイクルフック名)] で、ライフサイクルフックの名前を指定します。

   2. [Lifecycle transition (ライフサイクルの移行)] で、[Instance launch (インスタンスの起動)] を選択します。

   3. [ハートビートのタイムアウト] には、スケールアウト時にフックがタイムアウトするまで待機状態を維持する時間を秒単位で指定します。この時間の範囲は 30～7200 秒です。タイムアウト期間を長く設定すると、カスタムアクションが完了する時間が長くなります。次に、タイムアウト期間が終了する前に終了したら、complete-lifecycle-actionコマンドを送信してインスタンスが次の状態に進むことを許可します。

   4. [Default result] (デフォルトの結果) には、ライフサイクルフックのタイムアウト時間を過ぎた場合、または予期しない障害が発生した場合に実行するアクションを指定します。[続行] または 中止 のどちらかを選択できます。

      • [続行] を選択すると、Auto Scaling グループは他のライフサイクル フックを続行し、インスタンスをサービスに投入できます。

      • [中止] を選択する場合、Auto Scaling グループは残りのアクションをすべて停止し、インスタンスをただちに終了します。

   5. (オプション) [通知メタデータ] には、Amazon EC2 Auto Scaling が通知ターゲットにメッセージを送信するときに含めるその他の情報を指定します。

5. [作成] を選択します。

スケールイン用のライフサイクルフックを追加するには

1. スケールアウト用のライフサイクル フックを作成した後、[ライフサイクル フックの作成] を選択して、中断したところから続行します。

2. スケールイン (インスタンスを終了またはウォームプールに戻す) のライフサイクルフックを定義するには、以下を実行してください。

   1. [Lifecycle hook name (ライフサイクルフック名)] で、ライフサイクルフックの名前を指定します。

   2. [Lifecycle transition (ライフサイクルの移行)] で、[Instance terminate (インスタンスの終了)] を選択します。

   3. [ハートビートのタイムアウト] には、スケールアウト時にフックがタイムアウトするまで待機状態を維持する時間を秒単位で指定します。EC2 30 ログの取得など、最終的なタスクを実行するのに必要な時間にもよりますが、120タイムアウト時間を秒単位に短くすることをお勧めします。 CloudWatch

   4. [Default result] (デフォルトの結果) には、タイムアウト時間を超過した、または予期しない失敗が発生した場合に Auto Scaling グループが実行するアクションを指定します。[ABANDON] (中止) と [CONTINUE] (続行) は、どちらもインスタンスを終了します。

      • [CONTINUE] (続行) を選択する場合、Auto Scaling グループは、終了前に他のライフサイクルフックなどの残りのアクションを続行できます。

      • [中止] を選択すると、Auto Scaling グループはインスタンスをただちに終了します。

   5. (オプション) [通知メタデータ] には、Amazon EC2 Auto Scaling が通知ターゲットにメッセージを送信するときに含めるその他の情報を指定します。

3. [Create] を選択します。

ライフサイクルフックを追加する (AWS CLI)

コマンドを使用してライフサイクルフックを作成および更新します。put-lifecycle-hook

スケールアウトでアクションを実行するには、以下のコマンドを使用します。

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

スケールインでアクションを実行するには、以下のコマンドを使用します。

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

Amazon SNS または Amazon SQS を使用して通知を受信するには、--notification-target-arn および --role-arn オプションを追加します。

以下の例は、my-sns-topic という名前の SNS トピックを通知ターゲットとして指定するライフサイクルフックを作成します。

aws autoscaling put-lifecycle-hook --lifecycle-hook-name my-termination-hook  \
  --auto-scaling-group-name my-asg \
  --lifecycle-transition autoscaling:EC2_INSTANCE_TERMINATING \
  --notification-target-arn arn:aws:sns:region:123456789012:my-sns-topic \
  --role-arn arn:aws:iam::123456789012:role/my-notification-role

トピックは、以下のキーと値のペアが含まれたテスト通知を受け取ります。

"Event": "autoscaling:TEST_NOTIFICATION"

デフォルトでは、put-lifecycle-hook3600コマンドはハートビートタイムアウトを秒 (1 時間) に設定してライフサイクルフックを作成します。

既存のライフサイクルフックのハートビートタイムアウトを変更するには、以下の例にあるように、--heartbeat-timeout オプションを追加します。

aws autoscaling put-lifecycle-hook --lifecycle-hook-name my-termination-hook \
  --auto-scaling-group-name my-asg --heartbeat-timeout 120

インスタンスがすでに待機状態にある場合は、record-lifecycle-action-heartbeatCLI コマンドを使用してハートビートを記録することで、ライフサイクルフックがタイムアウトするのを防ぐことができます。これにより、ライフサイクルフックを作成するときに指定するタイムアウト時間によってタイムアウト期間が延長されます。タイムアウト期間が終了する前に終了した場合は、complete-lifecycle-actionCLI コマンドを送信してインスタンスが次の状態に進むことを許可できます。詳細な説明と例については、「ライフサイクルアクションを完了する」を参照してください。