Didacticiel : configurer un hook de cycle de vie qui appelle une fonction Lambda

Ouvrez la page Policies (Politiques) de la console IAM et sélectionnez Create policy (Créer une politique).

Choisissez l’onglet JSON.

Dans le Document de politique , collez le document de politique suivant dans la zone, en remplaçant le texte italics avec votre numéro de compte et le nom de votre groupe Auto Scaling.

Choisissez Suivant.

Pour Policy name (Nom de la politique), saisissez LogAutoScalingEvent-policy. Sélectionnez Create policy (Créer une politique).

Dans le panneau de navigation de gauche, sélectionnez Roles (Rôles).

Sélectionnez Create role (Créer un rôle).

Pour Select trusted entity (Sélectionner une entité de confiance), choisissez service AWS .

Pour votre cas d'utilisation, sélectionnez Lambda, puis Next (Suivant).

En dessous Ajouter des autorisations, choisissez la politique que vous avez créée (LogAutoScalingEvent-policy) et la politique nommée AWSLambdaBasicExecutionRole. Ensuite, choisissez Suivant.

Sur la page Name, review, and create (Nommer, vérifier et créer), pour Role name (Nom du rôle), saisissez LogAutoScalingEvent-role, puis choisissez Create role (Créer un rôle).

Ouvrez la page Functions (Fonctions) sur la console Lambda.

Sélectionnez Create function (Créer une fonction), puis Author from scratch (Créer à partir de zéro).

Sous Basic information (Informations de base), pour Function name (Nom de la fonction), entrez LogAutoScalingEvent.

Pour Durée d'exécution, choisissez Node.js 18x.

Faites défiler l’écran vers le bas et choisissez Modifier le rôle d’exécution par défaut, puis dans le champ Rôle d’exécution, choisissez Utiliser un rôle existant.

Pour Rôle existant, choisissez LogAutoScalingEvent-role.

Laissez les autres valeurs par défaut.

Sélectionnez Create function (Créer une fonction). Vous retournez au code et à la configuration de la fonction.

Vérifiez que votre fonction LogAutoScalingEvent est toujours ouverte dans la console, puis sous Code source, dans l’éditeur, copiez l’exemple de code suivant dans le fichier 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;
};

Ce code enregistre simplement l'événement afin qu'à la fin de ce didacticiel, vous puissiez voir un événement apparaître dans CloudWatch Enregistre le flux de journaux associé à cette fonction Lambda.

Choisissez Déployer.

Ouvrez la console EventBridge.

Dans le panneau de navigation, choisissez Rules.

Choisissez Créer une règle.

Pour Define rule detail (Définir les détails de la règle), procédez comme suit :

1. Pour Nom, saisissez LogAutoScalingEvent-rule.

2. Pour Event bus (Bus d’événement), choisissez default (défaut). Quand un Service AWS si votre compte génère un événement, il est toujours redirigé vers le bus d'événements par défaut de votre compte.

3. Pour Type de règle, choisissez Règle avec un modèle d’événement.

4. Choisissez Suivant.

Pour Build event pattern (Créer un modèle d’événement), procédez comme suit :

1. Pour Source de l'événement, choisissez AWS événements ou EventBridge événements partenaires.

2. Faites défiler vers le bas jusqu’à Modèle d’événements, puis procédez comme suit :

3. 1. Pour Event source (Source d’événement), choisissez Services AWS.

   2. Pour Service AWS, choisissez Auto Scaling.

   3. Dans Event type (Type d'événement), choisissez Instance Launch and Terminate (Lancement et résiliation d'une instance).

   4. Par défaut, la règle correspond à tout événement de mise à l'échelle horizontale ou de montée en puissance. Pour créer une règle qui vous avertit lorsqu'un événement de scale-out se produit et qu'une instance est mise en état d'attente en raison d'un hook de cycle de vie, choisissez Événement (s) d'instance spécifique et sélectionnez EC2 Instance-launch Action du cycle de vie.

   5. Par défaut, la règle correspond à tout groupe Auto Scaling de la région. Pour que la règle corresponde à un groupe Auto Scaling spécifique, choisissez Nom(s) de groupe spécifique(s), puis sélectionnez le groupe.

   6. Choisissez Suivant.

Pour Select target(s) (Sélectionner la ou les cibles), procédez comme suit :

1. Pour Target types (Types de cibles), choisissez Service AWS.

2. Pour Select a target (Sélectionner une cible), choisissez Lambda Function (Fonction Lambda).

3. Pour Fonction, choisissez LogAutoScalingEvent.

4. Choisissez Next (Suivant) deux fois.

Sur la page Vérifier et créer, choisissez Créer une règle.

Ouvrez la page des groupes Auto Scaling de la console Amazon EC2.

Cochez la case située en regard de votre groupe Auto Scaling. Un volet fractionné s'ouvre en bas de la page.

Dans le volet inférieur, sous l'onglet Gestion des instances, accédez à Hooks de cycle de vie et choisissez Créer un hook de cycle de vie.

Pour définir un hook de cycle de vie pour la montée en puissance (lancement d’instances), procédez comme suit :

1. Dans le champ Nom du hook de cycle de vie, saisissez LogAutoScalingEvent-hook.

2. Dans le champ Transition du cycle de vie, choisissez Lancement d'instance.

3. Dans Délai de pulsation, saisissez 300 pour définir le nombre de secondes d'attente d'un rappel de votre fonction Lambda.

4. Dans le champ Résultat par défaut, choisissez ABANDONNER. Cela signifie que le groupe Auto Scaling résiliera une nouvelle instance si le hook expire sans recevoir de rappel de votre fonction Lambda.

5. (Facultatif) Laissez le champ Métadonnées de notification vide. Les données d'événements que nous transmettons à EventBridge contient toutes les informations nécessaires pour appeler la fonction Lambda.

Cliquez sur Créer.

Ouvrez la page des groupes Auto Scaling de la console Amazon EC2.

Cochez la case située en regard de votre groupe Auto Scaling pour afficher les détails dans le volet inférieur tout en continuant à voir les premières lignes du volet supérieur.

Dans le volet inférieur, sous l'onglet Détails, choisissez Détails du groupe puis Modifier.

Pour Desired capacity (Capacité désirée), augmentez la valeur actuelle de 1.

Choisissez Mettre à jour. Pendant le lancement de l'instance, la colonne Statut du volet supérieur affiche le statut Mise à jour de la capacité.

Ouvrez le Page des groupes de journaux de la CloudWatch console.

Sélectionnez le nom du groupe de journaux pour votre fonction Lambda (/aws/lambda/LogAutoScalingEvent).

Sélectionnez le nom du flux de journaux pour afficher les données fournies par la fonction pour l'action de cycle de vie.

Revenez à la page Groupes Auto Scaling et sélectionnez votre groupe.

Dans l'onglet Activité, sous Historique de l'activité, la colonne Statut indique si votre groupe Auto Scaling a réussi à lancer une instance.

Ouvrez la page des groupes Auto Scaling de la console Amazon EC2.

Cochez la case située en regard de votre groupe Auto Scaling.

Sous l'onglet Gestion des instances, accédez à Hooks de cycle de vie et choisissez le hook de cycle de vie (LogAutoScalingEvent-hook).

Sélectionnez Actions, Delete (Supprimer).

Pour confirmer, choisissez de nouveau Delete (Supprimer).

Ouvrez le Page des règles en Amazonie EventBridge console.

Sous Bus d'événement, choisissez le bus d'événement associé à la règle (Default).

Ensuite, activez la case à cocher en regard de votre règle (LogAutoScalingEvent-rule).

Sélectionnez Supprimer.

Lorsque vous êtes invité à confirmer, saisissez le nom de la règle et choisissez Delete (Supprimer).

Ouvrez la page Functions (Fonctions) sur la console Lambda.

Choisissez la fonction (LogAutoScalingEvent).

Sélectionnez Actions, Supprimer.

Lorsque vous êtes invité à confirmer, saisissez delete pour confirmer la suppression de la fonction spécifiée, puis choisissez Delete (Supprimer).

Ouvrez le Page des groupes de journaux de la CloudWatch console.

Sélectionnez le groupe de journaux de la fonction (/aws/lambda/LogAutoScalingEvent).

Sélectionnez Actions, Delete log group(s) (Supprimer le ou les groupes de journaux).

Dans la boîte de dialogue Delete log group(s) (Supprimer le ou les groupes de journaux), sélectionnez Delete (Supprimer).

Ouvrez la page Roles (Rôles) de la console IAM.

Sélectionnez le rôle de la fonction (LogAutoScalingEvent-role).

Sélectionnez Supprimer.

Lorsque vous êtes invité à confirmer, saisissez le nom du rôle et choisissez Delete (Supprimer).

Ouvrez la page Policies (Politiques) de la console IAM.

Sélectionnez la politique que vous avez créée (LogAutoScalingEvent-policy).

Sélectionnez Actions, Supprimer.

Lorsque vous êtes invité à confirmer, saisissez le nom de la politique et choisissez Delete (Supprimer).