チュートリアル:Lambda 関数を呼び出すライフサイクルフックの設定

IAM コンソールの [ポリシーページ] を開き、[ポリシーの作成] を選択します。

[JSON] タブを選択します。

[ポリシードキュメント] ボックスに、次のポリシードキュメントを貼り付け、[イタリック体] のテキストはアカウント番号と Auto Scaling グループの名前に置き換えます。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "autoscaling:CompleteLifecycleAction"
      ],
      "Resource": "arn:aws:autoscaling:*:123456789012:autoScalingGroup:*:autoScalingGroupName/my-asg"
    }
  ]
}

[Next] を選択します。

[ポリシー名] に「LogAutoScalingEvent-policy」と入力します。[Create policy] を選択します。

左側のナビゲーションペインで、[Roles] を選択します。

[ロールの作成] を選択します。

[Select trusted entity] (信頼されたエンティティの選択) で、[AWS のサービス] を選択します。

ユースケースに [Lambda] を選択してから、[Next] (次へ) を選択します。

[Add permissions] (許可を追加) で、作成したポリシー ([LogAutoScalingEvent-policy]) と、[AWSLambdaBasicExecutionRole] という名前のポリシーを選択します。[次へ] を選択します。

[Name, review, and create] (名前、確認、および作成) ページで、[Role name] (ロール名) に LogAutoScalingEvent-role を入力し、[Create role] (ロールを作成) を選択します。

Lambda コンソールで [Functions (関数)] ページを開きます。

[関数の作成] を選択し、[一から作成] を選択します。

[基本的な情報] の [関数名] に「LogAutoScalingEvent」と入力します。

[ランタイム] で [Node.js 18.x] を選択します。

スクロールして [デフォルトの実行ロールの変更]を選択し、[実行ロール] で、[既存のロールを使用] を選択します。

既存の[ロール] で、[ログ オート スケーリングイベント ロール] を選択します。

他はデフォルト値のままにしておきます。

[機能の作成]を選択します。関数のコードと設定に戻ります。

コンソールで LogAutoScalingEvent 関数を開いたまま、エディタの [コードソース] で、index.mjs  という名前のファイルに次のサンプルコードを貼り付けます。

import { AutoScalingClient, CompleteLifecycleActionCommand } from "@aws-sdk/client-auto-scaling";
export const handler = async(event) => {
  console.log('LogAutoScalingEvent');
  console.log('Received event:', JSON.stringify(event, null, 2));
  var autoscaling = new AutoScalingClient({ region: event.region });
  var eventDetail = event.detail;
  var params = {
    AutoScalingGroupName: eventDetail['AutoScalingGroupName'], /* required */
    LifecycleActionResult: 'CONTINUE', /* required */
    LifecycleHookName: eventDetail['LifecycleHookName'], /* required */
    InstanceId: eventDetail['EC2InstanceId'],
    LifecycleActionToken: eventDetail['LifecycleActionToken']
  };
  var response;
  const command = new CompleteLifecycleActionCommand(params);
  try {
    var data = await autoscaling.send(command);
    console.log(data); // successful response
    response = {
      statusCode: 200,
      body: JSON.stringify('SUCCESS'),
    };
  } catch (err) {
    console.log(err, err.stack); // an error occurred
    response = {
      statusCode: 500,
      body: JSON.stringify('ERROR'),
    };
  }
  return response;
};

このコードは単にイベントをログに記録するので、このチュートリアルの最後に、この Lambda 関数に関連付けられている CloudWatch Logsのログ ストリーミングにイベントが表示されます。

[デプロイ] を選択します。

[EventBridge コンソール] を開きます。

ナビゲーションペインで ルール] を選択します。

[Create rule] (ルールの作成) を選択します。

[Define rule detail] (詳細の定義) で、次の操作を行います。

1. [名前] に LogAutoScalingEvent-rule と入力します。

2. [イベントバス] として、[デフォルト] を選択します。アカウント内の AWS のサービスがイベントを生成すると、イベントは常にアカウントのデフォルトイベントバスに送られます。

3. ルールタイプ では、イベントパターンを持つルール] を選択します。

4. [Next] を選択します。

[Build event pattern] (イベントパターンの作成) で、次の操作を行います。

1. [Event source] (イベントソース) で、[AWS events or EventBridge partner events] ( イベントまたは EventBridge パートナーイベント) を選択します。

2. [イベントパターン] までスクロールして、次の操作を行います。

3. 1. イベントソース で AWS のサービス を選択します。

   2. [AWS のサービス] には、[Auto Scaling] を選択します。

   3. [イベントタイプ] で、[インスタンスの起動と終了] を選択します。

   4. デフォルトで、ルールはすべてのスケールインイベントまたはスケールアウトイベントに一致します。スケールアウトイベントが発生し、ライフサイクルフックに基づいてインスタンスが待機状態になったときに通知するルールを作成するには、[Specific instance event(s)] (特定のインスタンスイベント) を選択してから、[EC2 Instance-launch Lifecycle Action] (EC2 インスタンス起動ライフサイクルアクション) を選択します。

   5. デフォルトでは、このルールはリージョン内のすべての Auto Scaling グループと一致します。ルールを特定の Auto Scaling グループに一致させるには、[特定のグループ名] を選択してグループを選択します。

   6. [Next] を選択します。

[Select target(s)] (ターゲットを選択) で、以下の操作を行います。

1. [Target types] (ターゲットタイプ) には、[AWS のサービス] を選択します。

2. [Select a target] (ターゲットを選択) では、[Lambda function] (Lambda 関数) を選択します。

3. [Function] (機能) には、[LogAutoScalingEvent] を選択します。

4. [次へ] を 2 回選択します。

[Review and create] (確認して作成) ページで、[Create rule] (ルールの作成) を選択します。

Amazon EC2 コンソールで Auto Scaling グループのページを開きます。

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

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

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

1. [ライフサイクルフック名] で、LogAutoScalingEvent-hookを入力します。

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

3. [ハートビートのタイムアウト] で、Lambda 関数からのコールバックを待機する秒数として300を入力します。

4. [デフォルトの結果] で、[中止] を選択します。つまり、Lambda 関数からコールバックを受け取らずにフックがタイムアウトすると、Auto Scaling グループは新しいインスタンスを終了します。

5. （オプション）[通知メタデータ] を空にします。EventBridge に渡すイベントデータには、Lambda 関数を呼び出すために必要な情報がすべて含まれています。

[Create] (作成) を選択します。

Amazon EC2 コンソールで Auto Scaling グループのページを開きます。

Auto Scaling グループの横にあるチェックボックスを選択すると、下部のペインに詳細が表示され、上部のペインの一番上の行が表示されます。

下部のペインの [詳細] タブで、[グループの詳細] 、[編集] を順に選択します。

[Desired capacity (希望するキャパシティ)] の場合は、現在の値を 1 ずつ増やします。

[Update] (更新) を選択します。インスタンスの起動中は、上部ペインの [Status (ステータス)] 列に [Updating capacity (キャパシティの更新)] というステータスが表示されます。

Amazon CloudWatch コンソールの [[Log groups (ロググループ)] ページ] を開きます。

Lambda 関数 (/aws/lambda/LogAutoScalingEvent) のロググループの名前を選択します。

ライフサイクルアクションの関数によって提供されるデータを表示するログのストリーミング名を選択します。

[Auto Scaling グループ] ページに戻り、グループを選択します。

[アクティビティ] タブの [アクティビティ履歴] では、[ステータス] 列に、Auto Scaling グループがインスタンスを正常に起動したかどうかが表示されます。

Amazon EC2 コンソールで Auto Scaling グループのページを開きます。

Auto Scaling グループの横にあるチェックボックスを選択します。

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

[アクション]、[削除] の順に選択します。

確認のために、もう一度 [削除] を選択します。

Amazon EventBridge コンソールで [Rules] (ルール) ページを開きます。

[Event bus (イベントバス)] で、ルール (Default) に関連付けられているイベントバスを選択します。

LogAutoScalingEvent-rule ルールの横にあるチェックボックスをオンにします。

[削除] を選択します。

確認を求められたら、ルールの名前を入力し、[Delete] (削除) を選択します。

Lambda コンソールで [Functions (関数)] ページを開きます。

関数 (LogAutoScalingEvent) を選択します。

[アクション]、[削除] の順に選択します。

確認を求められたら、delete を入力して指定した関数の削除を確認し、[Delete] (削除) を選択します。

Amazon CloudWatch コンソールの [Log groups (ロググループ)] ページを開きます。

関数のロググループ (/aws/lambda/LogAutoScalingEvent) を選択します。

[アクション]、[ロググループの削除] の順にクリックします。

ロググループの削除ダイアログボックスで、[削除] をクリックします。

IAM コンソールの [Roles (ロール)] ページを開きます。

関数のロール (LogAutoScalingEvent-role) を選択します。

[削除] を選択します。

確認を求められたら、ロールの名前を入力し、[Delete] (削除) を選択します。

IAM コンソールのポリシーページを開きます。

作成したポリシーを選択します。(LogAutoScalingEvent-policy)

[アクション]、[削除] の順に選択します。

確認を求められたら、ポリシーの名前を入力し、[Delete] (削除) を選択します。