Démarrage avec Lambda - AWS Lambda

Démarrage avec Lambda

Pour démarrer avec Lambda, utilisez la console Lambda pour créer une fonction. En quelques minutes, vous pouvez créer et appeler une fonction, puis afficher des journaux, des métriques et des données de suivi.

Note

Pour utiliser Lambda et d'autres services AWS, vous avez besoin d'un compte AWS. Si vous n'avez pas de compte, rendez-vous sur aws.amazon.com et choisissez Créer un compte AWS. Pour obtenir des instructions, consultez Comment créer et activer un nouveau compte AWS ?

Une bonne pratique consiste à créer un utilisateur (IAM) AWS Identity and Access Management avec des autorisations d'administrateur, puis à employer cet utilisateur IAM pour toutes les tâches n'exigeant pas d'informations d'identification racine. Créez un mot de passe pour l'accès à la console, et créez des clés d'accès pour utiliser les outils de ligne de commande. Pour plus d'informations, consultez Création de votre premier utilisateur administrateur et groupe IAM dans le Guide de l'utilisateur IAM.

Vous pouvez créer des fonctions dans la console Lambda ou avec une boîte à outils pour environnement de développement intégré (IDE), des outils de ligne de commande ou des kits AWS SDK. La console Lambda fournit un éditeur de code pour les langages non compilés, qui vous permet de modifier et de tester du code rapidement. L'AWS Command Line Interface (AWS CLI) vous donne un accès direct à l'API Lambda pour la configuration avancée et les cas d'utilisation de l'automatisation.

Vous déployez votre code de fonction sur Lambda à l'aide d'un package de déploiement. Lambda prend en charge deux types de packages de déploiement :

Créer une fonction Lambda à l'aide de la console

Dans cet exercice de démarrage, vous créez une fonction Lambda à l'aide de la console. La fonction utilise le code par défaut créé par Lambda. La console Lambda fournit un éditeur de code pour les langages non compilés, qui vous permet de modifier et de tester du code rapidement. Pour les langues compilées, vous devez créer un package de déploiement d'archives .zip pour charger votre code de fonction Lambda.

Créer la fonction

Vous créez ensuite une fonction Lambda Node.js à l'aide de la console Lambda. Lambda crée automatiquement le code par défaut pour la fonction.

Pour créer une fonction Lambda à l'aide de la console

  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Sélectionnez Create function (Créer une fonction).

  3. Sous Informations de base, procédez comme suit :

    1. Sous Function name (Nom de la fonction), saisissez my-function.

    2. Pour Runtime (Exécution), confirmez que Node.js 14.x est sélectionné. Notez que Lambda fournit des runtimes pour .NET (PowerShell, C#) Go, Java, Node.js, Python et Ruby.

  4. Sélectionnez Create function (Créer une fonction).

Lambda crée une fonction Node.js et un rôle d'exécution qui accorde à la fonction l'autorisation de charger des journaux. La fonction Lambda endosse le rôle d'exécution lorsque vous appelez votre fonction, et l'utilise pour créer des informations d'identification pour le kit SDK AWS et lire les données à partir des sources d'événements.

Appeler la fonction Lambda

Appelez votre fonction Lambda à l'aide de l'échantillon de données d'événements fourni dans la console.

Pour appeler une fonction

  1. Après avoir sélectionné votre fonction, choisissez l'onglet Test.

  2. Dans la section Test event (Événement de test), choisissez New event (Nouvel événement). Dans Template (Modèle), laissez l'option hello-world par défaut. Saisissez un Nom pour ce test et notez l'exemple de modèle d'événement suivant :

    { "key1": "value1", "key2": "value2", "key3": "value3" }
  3. Choisissez Save changes (Enregistrer les modifications), puis Test. Chaque utilisateur peut créer jusqu'à 10 événements de test par fonction. Ces événements de test ne sont pas disponibles pour les autres utilisateurs.

    Lambda exécute votre fonction en votre nom. Le gestionnaire de fonctions reçoit et traite l'exemple d'événement.

  4. Lorsque l’opération réussit, vérifiez les résultats dans la console.

    • Execution result (le résultat de l'exécution) affiche l'état d'exécution comme succeeded (réussi). Choisissez Details (Détails) pour afficher les résultats de l'exécution de la fonction. Notez que le lien Journaux ouvre la page Groupes de journaux dans la console CloudWatch.

    • La section Summary affiche les informations de clé présentées dans la section Log output (ligne REPORT dans le journal d'exécution).

    • La section Log output (Sortie de journal) affiche le journal que Lambda génère pour chaque appel. La fonction écrit ces journaux dans CloudWatch. La console Lambda présente ces journaux pour votre commodité. Choisissez Click here (Cliquez ici) pour ajouter des journaux au groupe de journaux CloudWatch et ouvrez la page Log groups (Groupes de journaux) dans la console CloudWatch.

  5. Exécutez la fonction (choisissez Test) plusieurs fois pour collecter des métriques que vous examinerez à l'étape suivante.

  6. Choisissez l'onglet Monitor (Surveiller). Cette page affiche des graphiques pour les métriques que Lambda envoie à CloudWatch.

    Pour en savoir plus sur ces graphiques, consultez Fonctions de surveillance sur la console Lambda.

Nettoyage

Si vous avez terminé d'utiliser l'exemple de fonction, supprimez-le. Vous pouvez également supprimer le groupe de journaux qui stocke les journaux de la fonction, et le rôle d'exécution créé par la console.

Pour supprimer une fonction Lambda

  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Choisissez une fonction.

  3. Sélectionnez Actions, Supprimer.

  4. Dans la boîte de dialogue Delete function (Supprimer une fonction), sélectionnez Delete (Supprimer).

Pour supprimer le groupe de journaux

  1. Ouvrez la page Log Groups (Groupes de journaux) de la console CloudWatch.

  2. Sélectionnez le groupe de journaux de la fonction (/aws/lambda/my-function).

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

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

Pour supprimer le rôle d'exécution

  1. Accédez à la page Roles (Rôles) de la AWS Identity and Access Management console (IAM).

  2. Sélectionnez le rôle de la fonction (my-function-role-31exxmpl).

  3. Choisissez Supprimer le rôle.

  4. Dans la boîte de dialogue Delete role (Supprimer le rôle), sélectionnez Yes, delete (Oui, supprimer).

Vous pouvez automatiser la création et le nettoyage des fonctions, des groupes de journaux et des rôles avec AWS CloudFormation et AWS Command Line Interface (AWS CLI). Pour obtenir des exemples d'applications entièrement fonctionnelles, consultez Exemples d'applications Lambda.