Tutorial: Konfigurieren eines Lebenszyklus-Hook, der eine Lambda-Funktion aufruft

Öffnen Sie in der IAM-Konsole Policies (Richtlinien) und wählen Sie dann Create policy (Richtlinie erstellen) aus.

Wählen Sie den Tab JSON.

Im Kästchen Policy Document fügen Sie das folgende Richtliniendokument in das Feld ein und ersetzen den Text in Kursivschrift mit Ihrer Kontonummer und dem Namen Ihrer Auto-Scaling-Gruppe.

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

Wählen Sie Weiter aus.

Geben Sie unter Policy name (Richtlinienname) LogAutoScalingEvent-policy ein. Wählen Sie Richtlinie erstellen aus.

Wählen Sie im Navigationsbereich auf der linken Seite Roles (Rollen).

Wählen Sie Rolle erstellen aus.

Wählen Sie für Select trusted entity (Vertrauenswürdige Entität auswählen) die Option AWS -Dienst.

Wählen Sie für Ihren Anwendungsfall Lambda und dann Next (Weiter) aus.

Wählen Sie unter Berechtigungen hinzufügen die Richtlinie aus, die Sie erstellt haben (LogAutoScalingEvent-policy), und die benannte Richtlinie aus. AWSLambdaBasicExecutionRole Wählen Sie anschließend Weiter.

Geben Sie auf der Seite Set role name and review (Rollenname festlegen und überprüfen) für Role name (Rollenname) LogAutoScalingEvent-role ein und wählen Sie Create role (Rolle erstellen) aus.

Öffnen Sie die Funktions-Seite in der Lambda-Konsole.

Wählen Sie Funktion erstellen und Von Grund auf neu erstellen aus.

Geben Sie unter Basic Information (Grundlegende Informationen) für Function name (Funktionsname) LogAutoScalingEvent ein.

Wählen Sie unter Laufzeit die Option Node.js 18.x aus.

Scrollen Sie nach unten und wählen Sie Ändern der standardmäßigen Ausführungsrolle und dann unter Ausführungsrolle Verwenden einer vorhandenen Rolle aus.

Wählen Sie für Existing role die Option -role aus. LogAutoScalingEvent

Übernehmen Sie im Übrigen die Standardwerte.

Wählen Sie Funktion erstellen. Sie kehren zum Code und zur Konfiguration der Funktion zurück.

Fügen Sie bei geöffneter LogAutoScalingEvent-Funktion in der Konsole unter Code-Quelle im Editor den folgenden Beispielcode in die Datei index.mjs ein.

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;
};

Dieser Code protokolliert einfach das Ereignis, sodass Sie am Ende dieses Tutorials sehen können, dass ein Ereignis im CloudWatch Log-Log-Stream erscheint, das mit dieser Lambda-Funktion verknüpft ist.

Wählen Sie Bereitstellen.

Öffnen Sie die EventBridge-Konsole.

Wählen Sie im Navigationsbereich Rules aus.

Wählen Sie Regel erstellen aus.

Zum Define rule detail (Festlegen der Regeldetails) gehen Sie folgendermaßen vor:

1. Geben Sie unter Name LogAutoScalingEvent-rule ein.

2. Bei Event bus (Ereignisbus) wählen Sie default (Standard) aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis generiert, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.

3. Bei Rule type (Regeltyp) wählen Sie Rule with an event pattern (Regel mit einem Ereignismuster) aus.

4. Wählen Sie Weiter aus.

Bei Build event pattern (Ereignis-Muster erstellen) gehen Sie wie folgt vor:

1. Wählen Sie als Eventquelle AWS Events oder EventBridge Partnerevents aus.

2. Scrollen Sie nach unten zu Ereignis-Muster und gehen Sie wie folgt vor:

3. 1. Wählen Sie für Ereignisquelle die Option AWS-Services aus.

   2. Für AWS-Service, wählen Sie Auto Scaling aus.

   3. Wählen Sie in Event Type (Ereignistyp) die Option Instance Launch and Terminate (Starten und Beenden von Instances) aus.

   4. Standardmäßig entspricht die Regel jedem Abskalierungs- oder Aufskalierungs-Ereignis. Um eine Regel zu erstellen, die Sie benachrichtigt, wenn ein Aufskalierungs-Ereignis vorliegt und eine Instance aufgrund eines Lebenszyklus-Hook in einen Wartezustand versetzt wird, wählen Sie Specific instance event(s) (Bestimmte Instance-Ereignisse) und wählen Sie EC2 Instance-launch Lifecycle Action (Lebenszyklusaktion beim Start von EC2-Instances) aus.

   5. Standardmäßig stimmt die Regel mit jeder Auto-Scaling-Gruppe in der Region überein. Damit die Regel mit einer bestimmten Auto-Scaling-Gruppe übereinstimmt, wählen Sie Specific group name(s) und wählen Sie dann die Gruppe aus.

   6. Wählen Sie Weiter aus.

Bei Select target(s) (Ziel(e) auswählen) gehen Sie wie folgt vor:

1. Für Target types (Zieltypen), wählen Sie AWS-Service aus.

2. Für Select a target (Ein Ziel auswählen), wählen die Option Lambda function (Lambda-Funktion) aus.

3. Wählen Sie für Funktion die Option LogAutoScalingEvent.

4. Klicken Sie zweimal auf Weiter.

Wählen Sie auf der Seite Überprüfen und erstellen die Option Regel erstellen aus.

Öffnen Sie die Seite Auto-Scaling-Gruppen in der Amazon-EC2-Konsole.

Aktivieren Sie das Kontrollkästchen neben Ihrer Auto-Scaling-Gruppe. Im unteren Teil der Seite wird ein geteilter Bereich geöffnet.

Wählen Sie im unteren Bereich auf der Registerkarte Instance management (Instance-Verwaltung) unter Lebenszyklus-Hooks die Option Create Lebenszyklus hook (Lebenszyklus-Hook erstellen) aus.

Gehen Sie wie folgt vor, um einen Lebenszyklus-Hook zum Aufskalieren (Start von Instances) zu definieren:

1. Geben Sie für Lebenszyklus-Hooks den Wert LogAutoScalingEvent-hook ein.

2. Wählen Sie bei Lifecycle Transition (Lebenszykluswechsel) die Option Instance launch (Instance-Start) aus.

3. Für Heartbeat-Zeitüberschreitung geben Sie den Wert 300 für die Anzahl an Sekunden ein, um auf einen Rückruf von Ihrer Lambda-Funktion zu warten.

4. Für Standardergebnis wählen Sie ABBRECHEN aus. Dies bedeutet, dass die Auto-Scaling-Gruppe eine neue Instance beendet, wenn die Zeitüberschreitung des Hook erreicht ist, ohne einen Rückruf von Ihrer Lambda-Funktion erhalten zu haben.

5. (Optional) Lassen Sie Benachrichtigungs-Metadaten leer. Die Ereignisdaten, an die wir übergeben, EventBridge enthalten alle notwendigen Informationen, um die Lambda-Funktion aufzurufen.

Wählen Sie Erstellen.

Öffnen Sie die Seite Auto-Scaling-Gruppen in der Amazon-EC2-Konsole.

Aktivieren Sie das Kontrollkästchen neben der Auto-Scaling-Gruppe, um Details in einem unteren Bereich anzuzeigen und weiterhin die oberen Zeilen des oberen Bereichs anzuzeigen.

Wählen Sie im unteren Bereich auf der Registerkarte Details die Option Gruppendetails, Bearbeiten aus.

Erhöhen Sie für Desired capacity (Gewünschte Kapazität den aktuellen Wert um 1.

Wählen Sie Aktualisieren. Während eine Instance gestartet wird, zeigt die Spalte Status den Status Updating capacity (Kapazität aktualisieren) an.

Öffnen Sie die Seite Protokollgruppen der CloudWatch Konsole.

Wählen Sie den Namen der Protokollgruppe für Ihre Lambda-Funktion aus (/aws/lambda/LogAutoScalingEvent).

Wählen Sie den Namen des Protokoll-Streams aus, um die von der Funktion für die Lebenszyklus-Aktion bereitgestellten Daten anzuzeigen.

Wählen Sie auf der Seite Auto-Scaling-Gruppen Ihre Gruppe aus.

Auf der Registerkarte Activity (Aktivität) wird unter Activity history (Aktivitätsverlauf) in der Spalte Status angezeigt, ob Ihre Auto-Scaling-Gruppe Instances erfolgreich gestartet hat.

Öffnen Sie die Seite Auto-Scaling-Gruppen in der Amazon-EC2-Konsole.

Aktivieren Sie das Kontrollkästchen neben Ihrer Auto-Scaling-Gruppe.

Wählen Sie auf der Registerkarte Instance management (Instance-Verwaltung) unter Lebenszyklus-Hooks den Lebenszyklus (LogAutoScalingEvent-hook) aus.

Wählen Sie Actions (Aktionen), Delete (Löschen) aus.

Um dies zu bestätigen, wählen Sie erneut Delete (Löschen) aus.

Öffnen Sie die Seite Regeln in der EventBridge Amazon-Konsole.

Wählen Sie in Event bus (Ereignisbus) den Ereignisbus aus, der der Regel zugeordnet ist (Default).

Aktivieren Sie das Kontrollkästchen neben Ihrer Regel (LogAutoScalingEvent-rule).

Wählen Sie Löschen aus.

Wenn Sie zur Bestätigung aufgefordert werden, geben Sie den Namen der Anwendung ein, und wählen Sie dann Delete aus.

Öffnen Sie die Seite Funktionen der Lambda-Konsole.

Wählen Sie die Funktion (LogAutoScalingEvent) aus.

Wählen Sie Aktionen, Löschen aus.

Wenn Sie zur Bestätigung aufgefordert werden, geben Siedeleteum die angegebene Funktion zu löschen und wählen Sie dannLöschen.

Öffnen Sie die Seite Protokollgruppen der CloudWatch Konsole.

Wählen Sie die Protokollgruppe der Funktion (/aws/lambda/LogAutoScalingEvent).

Wählen Sie Actions (Aktionen), Delete log group(s) (Protokollgruppe(n) löschen) aus.

Wählen Sie im Dialogfeld Delete log group(s) (Protokollgruppe(n) löschen) die Option Delete (Löschen) aus.

Öffnen Sie die Seite Roles (Rollen) in der IAM-Konsole.

Wählen Sie die Rolle der Funktion (LogAutoScalingEvent-role).

Wählen Sie Löschen aus.

Wenn Sie zur Bestätigung aufgefordert werden, geben Sie den Namen der Rolle ein und wählen Sie dann Delete (Löschen).

Öffnen Sie die Seite Richtlinien in der IAM-Konsole.

Wählen Sie die Richtlinie aus, die Sie erstellt haben (LogAutoScalingEvent-policy).

Wählen Sie Aktionen, Löschen aus.

Wenn Sie zur Bestätigung aufgefordert werden, geben Sie den Namen der Richtlinie ein und wählen Sie dann Delete (Löschen).