ライフサイクルフックを Auto Scaling グループに追加するための準備

[Lambda コンソール] を使用して Lambda 関数を作成し、Amazon リソースネーム (ARN) を書き留めておきます。例えば、arn:aws:lambda:region:123456789012:function:my-function。EventBridge ターゲットを作成するには ARN が必要です。詳細については、[AWS Lambda デベロッパーガイド] の [Lambda の開始方法] を参照してください。

インスタンス起動のイベントに一致するルールを作成するには、次の put-rule コマンドを使用します。

aws events put-rule --name my-rule --event-pattern file://pattern.json --state ENABLED

次の例は、インスタンス起動ライフサイクルアクションの pattern.json を示しています。イタリック体のテキストは、Auto Scaling グループの名前に置き換えてください。

{
  "source": [ "aws.autoscaling" ],
  "detail-type": [ "EC2 Instance-launch Lifecycle Action" ],
  "detail": {
      "AutoScalingGroupName": [ "my-asg" ]
   }
}

コマンドが正常に実行された場合は、ルールの ARN を使用して EventBridge が応答します。この ARN をメモします。これは、ステップ 4 で入力する必要があります。

他のイベントに一致するルールを作成するには、イベントパターンを変更します。詳細については、「Auto Scaling イベントの処理に EventBridge を使用する」を参照してください。

ルールのターゲットとして使用する Lambda 関数を指定するには、次のput-argetコマンドを実行します。

aws events put-targets --rule my-rule --targets Id=1,Arn=arn:aws:lambda:region:123456789012:function:my-function

上記のコマンドで、my-rule はステップ 2 でルールに指定した名前になり、Arn パラメータの値はステップ 1 で作成した関数の ARN になります。

ルールが Lambda 関数を呼び出せるようにする許可を追加するには、以下の Lambda add-permission コマンドを使用します。このコマンドは、EventBridge サービスのプリンシパル (events.amazonaws.com) 信頼し、指定のルールに許可を適用します。

aws lambda add-permission --function-name my-function --statement-id my-unique-id \
  --action 'lambda:InvokeFunction' --principal events.amazonaws.com --source-arn arn:aws:events:region:123456789012:rule/my-rule

上記のコマンドでは:

コマンドが正常に実行された場合は、次のような出力が表示されます。

{
  "Statement": "{\"Sid\":\"my-unique-id\",
    \"Effect\":\"Allow\",
    \"Principal\":{\"Service\":\"events.amazonaws.com\"},
    \"Action\":\"lambda:InvokeFunction\",
    \"Resource\":\"arn:aws:lambda:us-west-2:123456789012:function:my-function\",
    \"Condition\":
      {\"ArnLike\":
        {\"AWS:SourceArn\":
         \"arn:aws:events:us-west-2:123456789012:rule/my-rule\"}}}"
}

Statement 値は、Lambda 関数ポリシーに追加されたステートメントの JSON 文字列バージョンです。

これらの指示に従った後、次のステップとして「Auto Scaling グループにライフサイクル フックを追加する」に進みます。

Amazon SNS トピックを作成するには、[Amazon SNS コンソール] または次の [トピックの作成] のコマンドを使用します。このトピックが、使用している Auto Scaling グループと同じリージョンにあることを確認します。詳細については、[Amazon Simple 通知サービスデベロッパーガイド] の [Amazon SNS の使用開始] を参照してください。

aws sns create-topic --name my-sns-topic

その Amazon リソースネーム (ARN) をメモします、例えば、 arn:aws:sns:region:123456789012:my-sns-topic。ライフサイクルフックを作成するには、それが必要です。

IAM サービスロールを作成して、Amazon EC2 Auto Scaling に Amazon SNS 通知ターゲットへのアクセス権を付与します。

SNS トピックへの Amazon EC2 Auto Scaling のアクセス権を付与するには

1. IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。

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

3. [ロールの作成] を選択してください。

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

5. ユースケースでは、[他の AWS サービスのユースケース] で [EC2 Auto Scaling]、[EC2 Auto Scaling Notification Access] の順に選択します。

6. [Next] (次へ) を 2 回選択して、[Name, review, and create] (名前、確認、および作成) ページに進みます。

7. [Role name] (ロール名) にロールの名前 (my-notification-role など) を入力して、[Create role] (ロールを作成) を選択します。

8. [Roles (ロール)] ページで作成したロールを選択して、[Summary (概要)] ページを開きます。ロールの [ARN] をメモします。例えば、arn:aws:iam::123456789012:role/my-notification-role。ライフサイクルフックを作成するには、それが必要です。

これらの指示に従った後、次のステップとして「ライフサイクルフックを追加する (AWS CLI)」に進みます。

[Amazon SQS コンソール] を使用して、Amazon SQS キューを作成します。キューが,使用している Auto Scaling グループと同じリージョンにあることを確認します。詳細については、「Amazon Simple Queue Service デベロッパーガイド」の「Getting started with Amazon SQS」を参照してください。

キューの ARN をメモします。例えば、arn:aws:sqs:us-west-2:123456789012:my-sqs-queue。ライフサイクルフックを作成するには、それが必要です。

IAM サービスロールを作成して、Amazon EC2 Auto Scaling に Amazon SQS 通知ターゲットへのアクセス権を付与します。

SQS キューへ Amazon EC2 Auto Scaling のアクセス権を付与するには

1. IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。

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

3. [ロールの作成] を選択してください。

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

5. ユースケースでは、[他の AWS サービスのユースケース] で [EC2 Auto Scaling]、[EC2 Auto Scaling Notification Access] の順に選択します。

6. [Next] (次へ) を 2 回選択して、[Name, review, and create] (名前、確認、および作成) ページに進みます。

7. [Role name] (ロール名) にロールの名前 (my-notification-role など) を入力して、[Create role] (ロールを作成) を選択します。

8. [Roles (ロール)] ページで作成したロールを選択して、[Summary (概要)] ページを開きます。ロールの [ARN] をメモします。例えば、arn:aws:iam::123456789012:role/my-notification-role。ライフサイクルフックを作成するには、それが必要です。

これらの指示に従った後、次のステップとして「ライフサイクルフックを追加する (AWS CLI)」に進みます。

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

目的の Lambda 関数を選択します。

新しい Lambda 関数を作成する場合は、「Lambda 関数を作成する」を参照してください。

次に [設定] タブと [アクセス許可] を選択します。

[Resource-based policy (リソースベースのポリシー)] にスクロールダウンして [アクセス許可の追加] を選択します。リソースベースのポリシーを使用して、関数を呼び出すアクセス許可を、ポリシーで指定されているプリンシパルに付与します。この場合、プリンシパルは Auto Scaling グループに関連付けられている Amazon EC2 Auto Scaling service-linked role です。

[Policy statement (ポリシーステートメント)] セクションで、権限を設定します。

1. AWS アカウント を選択します。

2. Principal (プリンシパル) で、例えば arn:aws:iam::<aws-account-id>:role/aws-service-role/autoscaling.amazonaws.com/AWSServiceRoleForAutoScaling といった呼び出しサービスにリンクされたロールの ARN を入力します。

3. [Action (アクション)] で、[lambda:InvokeFunction] を選択します。

4. [Statement ID (ステートメント ID)] に AllowInvokeByAutoScaling といった一意のステートメント ID を入力します。

5. [保存] を選択します。

これらの指示に従った後、次のステップとして「ライフサイクルフックを追加する (AWS CLI)」に進みます。