Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Création de fonctions Lambda durables
Pour commencer à utiliser les fonctions durables Lambda, utilisez la console Lambda pour créer une fonction durable. En quelques minutes, vous pouvez créer et déployer une fonction durable qui utilise des étapes et des temps d'attente pour démontrer une exécution basée sur des points de contrôle.
Au cours de ce didacticiel, vous découvrirez les concepts fondamentaux des fonctions durables, tels que la façon d'utiliser l'DurableContextobjet, de créer des points de contrôle avec des étapes et de suspendre l'exécution avec des temps d'attente. Vous découvrirez également comment fonctionne le replay lorsque votre fonction reprend après une attente.
Pour simplifier les choses, vous devez créer votre fonction à l'aide de l'exécution Python ou Node.js. Avec ces langages interprétés, vous pouvez modifier le code de fonction directement dans l'éditeur de code intégré à la console.
Astuce
Pour apprendre à créer des solutions sans serveur, consultez le Guide du développeur sans serveur.
Conditions préalables
Si vous n'en avez pas Compte AWS, procédez comme suit pour en créer un.
Pour vous inscrire à un Compte AWS
Suivez les instructions en ligne.
Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique ou un SMS et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Lorsque vous vous inscrivez à un Compte AWS, un Utilisateur racine d'un compte AWSest créé. Par défaut, seul l’utilisateur racine a accès à l’ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l’utilisateur racine pour effectuer les tâches nécessitant un accès utilisateur racine.
AWS vous envoie un e-mail de confirmation une fois le processus d'inscription terminé. À tout moment, vous pouvez consulter l'activité actuelle de votre compte et gérer votre compte en accédant à https://aws.amazon.com/
Après vous être inscrit à un Compte AWS, sécurisez Utilisateur racine d'un compte AWS AWS IAM Identity Center, activez et créez un utilisateur administratif afin de ne pas utiliser l'utilisateur root pour les tâches quotidiennes.
Sécurisez votre Utilisateur racine d'un compte AWS
-
Connectez-vous en AWS Management Console
tant que propriétaire du compte en choisissant Utilisateur root et en saisissant votre adresse Compte AWS e-mail. Sur la page suivante, saisissez votre mot de passe. Pour obtenir de l’aide pour vous connecter en utilisant l’utilisateur racine, consultez Connexion en tant qu’utilisateur racine dans le Guide de l’utilisateur Connexion à AWS .
-
Activez l’authentification multifactorielle (MFA) pour votre utilisateur racine.
Pour obtenir des instructions, voir Activer un périphérique MFA virtuel pour votre utilisateur Compte AWS root (console) dans le guide de l'utilisateur IAM.
Création d’un utilisateur doté d’un accès administratif
-
Activez IAM Identity Center.
Pour obtenir des instructions, consultez Activation d’ AWS IAM Identity Center dans le Guide de l’utilisateur AWS IAM Identity Center .
-
Dans IAM Identity Center, octroyez un accès administratif à un utilisateur.
Pour un didacticiel sur l'utilisation du Répertoire IAM Identity Center comme source d'identité, voir Configurer l'accès utilisateur par défaut Répertoire IAM Identity Center dans le Guide de AWS IAM Identity Center l'utilisateur.
Connexion en tant qu’utilisateur doté d’un accès administratif
-
Pour vous connecter avec votre utilisateur IAM Identity Center, utilisez l’URL de connexion qui a été envoyée à votre adresse e-mail lorsque vous avez créé l’utilisateur IAM Identity Center.
Pour obtenir de l'aide pour vous connecter en utilisant un utilisateur d'IAM Identity Center, consultez la section Connexion au portail AWS d'accès dans le guide de l'Connexion à AWS utilisateur.
Attribution d’un accès à d’autres utilisateurs
-
Dans IAM Identity Center, créez un ensemble d’autorisations qui respecte la bonne pratique consistant à appliquer les autorisations de moindre privilège.
Pour obtenir des instructions, consultez Création d’un ensemble d’autorisations dans le Guide de l’utilisateur AWS IAM Identity Center .
-
Attribuez des utilisateurs à un groupe, puis attribuez un accès par authentification unique au groupe.
Pour obtenir des instructions, consultez Ajout de groupes dans le Guide de l’utilisateur AWS IAM Identity Center .
Créez une fonction Lambda durable avec la console
Dans cet exemple, votre fonction durable traite une commande en plusieurs étapes avec un point de contrôle automatique. La fonction prend un objet JSON contenant un numéro de commande, valide la commande, traite le paiement et confirme la commande. Chaque étape est automatiquement contrôlée. Ainsi, si la fonction est interrompue, elle reprend à partir de la dernière étape terminée.
Votre fonction illustre également une opération d'attente, interrompant l'exécution pendant une courte période pour simuler l'attente d'une confirmation externe.
Pour créer une fonction durable avec la console
Ouvrez la page Functions
(Fonctions) de la console Lambda. -
Choisissez Créer une fonction.
-
Sélectionnez Créer à partir de zéro.
-
Dans le volet Informations de base, pour Nom de la fonction, saisissez
.myDurableFunction -
Pour Runtime, choisissez Node.js 24 ou Python 3.14.
-
Sélectionnez Activer l'exécution durable.
Lambda crée votre fonction durable avec un rôle d'exécution qui inclut des autorisations pour les opérations de point de contrôle (lambda:CheckpointDurableExecutionset). lambda:GetDurableExecutionState
Note
Les environnements d'exécution Lambda incluent le SDK Durable Execution, qui vous permet de tester des fonctions durables sans créer de dépendances. Toutefois, nous vous recommandons d'inclure le SDK dans votre package de déploiement pour la production. Cela garantit la cohérence des versions et évite les mises à jour d'exécution potentielles susceptibles d'affecter votre fonction.
Utilisez l'éditeur de code intégré à la console pour ajouter votre code de fonction durable.
Invoquez la fonction durable à l'aide de l'éditeur de code de la console
Les fonctions durables nécessitent un ARN qualifié pour l'invocation. Avant de pouvoir invoquer votre fonction durable, publiez une version.
Pour publier une version de votre fonction
-
Choisissez l'onglet Versions.
-
Choisissez Publish new version (Publier une nouvelle version).
-
Dans le champ Description de la version, entrez
Initial version(facultatif). -
Choisissez Publier.
-
Lambda crée la version 1 de votre fonction. Notez que la fonction ARN inclut désormais
:1à la fin, ce qui indique qu'il s'agit de la version 1.
Créez maintenant un événement de test à envoyer à votre fonction. L'événement est un document au format JSON contenant un numéro de commande.
Pour créer l'événement de test
-
Dans la section ÉVÉNEMENTS DE TEST de l’éditeur de code de console, choisissez Créer un événement de test.
-
Dans Event Name (Nom de l'événement), saisissez
myTestEvent. -
Dans la section JSON d’événement, remplacez le JSON par défaut par ce qui suit :
{ "orderId": "order-12345" } -
Choisissez Enregistrer.
Pour tester votre fonctionnalité durable et en voir l'exécution
Dans la section ÉVÉNEMENTS DE TEST de l’éditeur de code de la console, cliquez sur l’icône d’exécution à côté de votre événement de test :
Votre fonction durable commence à s'exécuter. Comme il inclut une attente de 10 secondes, l'appel initial se termine rapidement et la fonction reprend après la période d'attente. Vous pouvez consulter la progression de l'exécution dans l'onglet Exécutions durables.
Pour visualiser l'exécution durable de vos fonctions
-
Choisissez l'onglet Exécutions durables.
-
Trouvez votre exécution dans la liste. L'exécution indique l'état actuel (en cours, réussi ou échec).
-
Choisissez l'ID d'exécution pour afficher les détails, notamment :
Chronologie d'exécution indiquant la date à laquelle chaque étape est terminée
Historique des points de contrôle
Périodes d'attente
Résultats des étapes
Vous pouvez également consulter les journaux de votre fonction dans CloudWatch Logs pour voir le résultat de chaque étape de la console.
Pour consulter les enregistrements d'invocation de votre fonction dans Logs CloudWatch
-
Ouvrez la page Groupes de journaux
de la CloudWatch console. -
Choisissez le groupe de journaux de votre fonction (
/aws/lambda/myDurableFunction). -
Faites défiler la page vers le bas et choisissez le flux de journaux pour les invocations de fonctions que vous souhaitez consulter.
Vous devriez voir des entrées de journal pour chaque appel de votre fonction, y compris l'exécution initiale et la rediffusion après l'attente.
Nettoyage
Lorsque vous avez fini d'utiliser l'exemple de fonction durable, 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 la fonction Lambda
-
Ouvrez la page Functions (Fonctions)
de la console Lambda. -
Sélectionnez la fonction que vous avez créée.
-
Sélectionnez Actions, Supprimer.
-
Saisissez
confirmdans la zone de saisie de texte et choisissez Delete (Supprimer).
Pour supprimer le groupe de journaux
-
Ouvrez la page Log groups (Groupes de journaux)
de la console CloudWatch. -
Sélectionnez le groupe de journaux de la fonction (
/aws/lambda/myDurableFunction). -
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).
Pour supprimer le rôle d'exécution
-
Ouvrez la page Rôles
de la console Gestion des identités et des accès AWS (IAM). -
Sélectionnez le rôle d'exécution de la fonction (par exemple,
myDurableFunction-role-).31exxmpl -
Sélectionnez Delete (Supprimer).
-
Dans la fenêtre de dialogue Supprimer le rôle, saisissez le nom du rôle, puis sélectionnez Supprimer.
Ressources supplémentaires et prochaines étapes
Maintenant que vous avez créé et testé une fonction simple et durable à l'aide de la console, procédez comme suit :
-
Découvrez les cas d'utilisation courants des fonctions durables, notamment les transactions distribuées, le traitement des commandes et les flux de travail de révision humaine. Voir les exemples.
-
Découvrez comment surveiller les exécutions de fonctions durables à l'aide de CloudWatch métriques et d'un historique d'exécution. Consultez la section Surveillance et débogage.
-
Découvrez comment invoquer des fonctions durables de manière synchrone et asynchrone, et comment gérer les exécutions de longue durée. Voir Invocation de fonctions durables.
-
Suivez les meilleures pratiques en matière de rédaction de code déterministe, de gestion de la taille des points de contrôle et d'optimisation des coûts. Consultez la section Bonnes pratiques.
-
Découvrez comment tester des fonctions durables localement et dans le cloud. Voir Tester des fonctions durables.