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).

Sélectionnez l’onglet JSON.

Dans la zone Policy Document (Document relatif à la politique), collez le document suivant, en remplaçant le texte en italique par votre numéro de compte et le nom de votre groupe Auto Scaling.

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

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).

Sous Ajouter des autorisations, choisissez la politique que vous avez créée (LogAutoScalingEvent-policy) et le nom AWSLambdaBasicExecutionRolede la politique. 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 Exécution, choisissez Node.js 18.x.

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 que, à la fin de ce didacticiel, vous puissiez voir un événement apparaître dans le flux de journal CloudWatch des journaux associé à cette fonction Lambda.

Choisissez Deploy (Déployer).

Ouvrez la EventBridge console.

Dans le volet de navigation, choisissez Règles.

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 Name (Nom), saisissez LogAutoScalingEvent-rule.

2. Pour Event bus (Bus d’événement), choisissez default (défaut). Lorsqu'un événement est généré Service AWS dans votre compte, 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. Dans Source de l'événement, sélectionnez AWS événements ou événements EventBridge 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 montée en puissance se produit et qu'une instance est dans un état d'attente en raison d'un hook de cycle de vie, choisissez Specific instance event(s) (Événement[s] d'instance spécifique[s]) et sélectionnez EC2 Instance-launch Lifecycle Action (Action du cycle de vie de l'instance EC2 : lancement).

   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 Next (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. Dans Fonction, sélectionnez 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énement que nous transmettons EventBridge contiennent toutes les informations nécessaires pour appeler la fonction Lambda.

Choisissez 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 la page 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 la page Règles dans la EventBridge console Amazon.

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 Delete (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 la page 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 Delete (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).