Utilisation des AWS Lambda fonctions - AWS Boîte à outils pour VS Code
PrérequisInvocation d'une fonction LambdaSuppression d'une fonction LambdaTéléchargement d'une fonction LambdaDéploiement de mises à jour pour les nouvelles fonctions LambdaTéléchargement de mises à jour pour les fonctions Lambda existantesConversion de votre fonction Lambda en projet AWS SAM

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.

Utilisation des AWS Lambda fonctions

AWS Toolkit for Visual Studio Code Cela vous permet de travailler avec vos AWS Lambda fonctions dans votre environnement VS Code local. Avec le AWS Toolkit, vous pouvez créer, modifier, tester, déboguer et déployer vos fonctions Lambda, sans avoir à quitter l'IDE. Pour obtenir des informations détaillées sur le AWS Lambda service, consultez le guide du AWS Lambdadéveloppeur.

Les sections suivantes décrivent comment commencer à utiliser les fonctions Lambda dans le. AWS Toolkit for Visual Studio Code

Note

Si vous avez déjà créé des fonctions Lambda à l'aide de AWS Management Console, vous pouvez les invoquer depuis le Toolkit. De plus, vous pouvez ouvrir vos fonctions Lambda dans VS Code à partir du AWS Lambda console, pour plus d'informations, voir la rubrique relative AWS Lambda console à l'IDE dans ce guide de l'utilisateur. Pour créer une nouvelle fonction Lambda dans VS Code, suivez les étapes décrites dans la rubrique Création d'une nouvelle application sans serveur (locale) de ce guide de l'utilisateur.

Prérequis

Les conditions suivantes doivent être remplies pour utiliser le AWS Lambda service dans le AWS kit d'outils.

  • La dernière version du AWS Toolkit for Visual Studio Code est installée et configurée avec vos AWS informations d'identification.

  • Vos autorisations et politiques gérées AWS Identity and Access Management (IAM) sont configurées pour fonctionner avec le AWS Lambda service. Pour obtenir des informations détaillées sur la façon de configurer vos autorisations et de créer une politique AWS gérée compatible, consultez AWS Identity and Access Management la AWS Lambda rubrique correspondante du Guide du AWS Lambda développeur.

  • Vous avez des AWS Lambda fonctions existantes ou vous savez comment en créer une. Pour obtenir des instructions sur la création d'une fonction Lambda, consultez la rubrique Création de votre première fonction Lambda dans le Guide du développeur.AWS Lambda

Invocation d'une fonction Lambda

Pour appeler une fonction Lambda depuis votre AWS compte dans VS Code, procédez comme suit.

  1. À partir de AWS Toolkit for Visual Studio Code, développez l' AWS explorateur.

  2. Dans l' AWS explorateur, développez Lambda pour afficher vos ressources Lambda.

  3. Ouvrez le menu contextuel pour (cliquez avec le bouton droit) sur la fonction Lambda que vous souhaitez invoquer, puis choisissez Invoke dans le cloud ou choisissez l'icône Invoke dans le cloud pour ouvrir le menu de configuration de l'appel à distance dans VS Code.

  4. Dans le menu de configuration de l'appel à distance, spécifiez vos paramètres de charge utile et ajoutez toute information supplémentaire requise pour l'événement.

    Note

    Le premier processus d'appel peut commencer à s'exécuter dès que vous choisissez Invoke dans le cloud dans l' AWS explorateur. La sortie est affichée dans l'onglet OUTPUT du terminal VS Code.

  5. Cliquez sur le bouton Remote Invoke pour appeler votre fonction. La sortie est affichée dans l'onglet OUTPUT du terminal VS Code.

Suppression d'une fonction Lambda

Pour supprimer une fonction Lambda, procédez comme suit.

Avertissement

N'utilisez pas cette procédure pour supprimer les fonctions Lambda qui sont associées à AWS CloudFormation. Ces fonctions doivent être supprimées de votre AWS CloudFormation pile.

  1. À partir de AWS Toolkit for Visual Studio Code, développez l' AWS explorateur.

  2. Dans l' AWS explorateur, développez Lambda pour afficher vos ressources Lambda.

  3. Cliquez avec le bouton droit sur la fonction Lambda que vous souhaitez supprimer, puis choisissez Supprimer.

  4. Lorsque vous y êtes invité, confirmez que vous souhaitez supprimer votre fonction.

Une fois la fonction supprimée, elle n'est plus répertoriée dans l' AWS explorateur.

Téléchargement d'une fonction Lambda

Vous pouvez télécharger le code d'une fonction Lambda distante dans votre espace de travail VS Code pour le modifier et le déboguer.

Note

Pour télécharger votre fonction Lambda, vous devez travailler dans un espace de travail VS Code avec un dossier accessible et le AWS Toolkit ne prend en charge cette fonctionnalité qu'avec les fonctions Lambda utilisant Node.js et les environnements d'exécution Python.

  1. À partir de AWS Toolkit for Visual Studio Code, développez l' AWS explorateur.

  2. Dans l' AWS explorateur, développez Lambda pour afficher vos ressources Lambda.

  3. Cliquez avec le bouton droit sur la fonction Lambda que vous souhaitez télécharger, puis sélectionnez Télécharger.

  4. Votre fonction Lambda s'ouvre dans l'éditeur VS Code et s'affiche dans l' AWS explorateur une fois le téléchargement terminé. Le AWS Toolkit crée également une configuration de lancement dans le panneau d'exécution de VS Code vous permettant d'exécuter et de déboguer la fonction Lambda localement avec. AWS Serverless Application Model Pour plus d'informations sur l'utilisation AWS SAM, consultezExécution et débogage d'une application sans serveur à partir d'un modèle (local).

Déploiement de mises à jour pour les nouvelles fonctions Lambda

Vous pouvez déployer des mises à jour des nouvelles fonctions Lambda depuis un emplacement temporaire non spécifié sur votre machine locale.

Note

Lorsque des modifications non déployées sont apportées à vos fichiers lambda, vous êtes averti par l'icône M située à côté des fichiers modifiés dans l'éditeur VS Code et dans l' AWS explorateur.

Déploiement depuis l'éditeur VS Code

  1. Ouvrez un fichier à partir de votre fonction Lambda dans l'éditeur VS Code, puis modifiez le fichier.

  2. Enregistrez manuellement depuis le menu principal de VS Code ou en appuyant sur option+s (Mac) ctrl+s (Windows).

  3. VS Code vous invite automatiquement à déployer vos modifications dans le cloud. Cliquez sur le bouton Déployer pour confirmer le déploiement.

  4. VS Code vous informe de l'état de votre déploiement et vous avertit lorsque le processus est terminé.

Déploiement depuis l' AWS explorateur

  1. Ouvrez un fichier à partir de votre fonction Lambda dans l'éditeur VS Code, puis modifiez le fichier.

  2. À partir de la AWS boîte à outils, développez l' AWS explorateur.

  3. Dans l' AWS explorateur, étendez la AWS région avec la fonction Lambda pour laquelle vous souhaitez déployer des modifications.

  4. Depuis la AWS région, développez Lambda et parcourez la fonction pour laquelle vous souhaitez déployer des modifications.

  5. Dans le menu rapide situé à côté de votre fonction, choisissez l'icône Enregistrer et déployer votre code.

  6. VS Code vous informe de l'état de votre déploiement et vous avertit lorsque le processus est terminé.

Téléchargement de mises à jour pour les fonctions Lambda existantes

Les procédures suivantes décrivent comment télécharger les modifications locales apportées à vos fonctions Lambda existantes. Cette fonctionnalité prend en charge les téléchargements avec n'importe quel environnement d'exécution compatible Lambda.

Avertissement

Avant de télécharger votre fonction lambda, tenez compte des points suivants :

  • La mise à jour du code de cette manière n'utilise pas la AWS SAM CLI pour le déploiement ou la création d'une AWS CloudFormation pile

  • Le AWS kit d'outils ne valide pas le code. Validez votre code et testez vos fonctions avant de télécharger les modifications dans le cloud.

Téléchargement d'une archive Zip

  1. À partir de AWS Toolkit for Visual Studio Code, développez l' AWS explorateur.

  2. Dans l' AWS explorateur, développez Lambda pour afficher vos ressources Lambda.

  3. Cliquez avec le bouton droit sur la fonction Lambda vers laquelle vous souhaitez télécharger vos modifications, puis choisissez Upload Lambda... pour ouvrir le menu Sélectionner le type de téléchargement.

  4. Choisissez Archive ZIP pour les localiser ZIP Archive dans votre répertoire local.

  5. Lorsque vous y êtes invité, confirmez le téléchargement pour démarrer le téléchargement du fichier sélectionnéZIP Archive.

  6. L'état de votre téléchargement est affiché dans VS Code et vous êtes averti lorsque le processus de téléchargement est terminé.

Télécharger un répertoire sans le créer

  1. À partir de AWS Toolkit for Visual Studio Code, développez l' AWS explorateur.

  2. Dans l' AWS explorateur, développez Lambda pour afficher vos ressources Lambda.

  3. Cliquez avec le bouton droit sur la fonction Lambda vers laquelle vous souhaitez télécharger vos modifications, puis choisissez Upload Lambda... pour ouvrir le menu Sélectionner le type de téléchargement.

  4. Choisissez Directory pour passer à l'écran Build directory.

  5. Dans l'écran Créer un répertoire, choisissez Non pour choisir un répertoire local à télécharger.

  6. Lorsque vous y êtes invité, confirmez le téléchargement pour télécharger le répertoire sélectionné.

  7. L'état de votre téléchargement est affiché dans VS Code et vous êtes averti lorsque le processus de téléchargement est terminé.

Téléchargement d'un répertoire avec un build
Note

Tenez compte des points suivants :

  • Cette procédure nécessite la AWS Serverless Application Model CLI.

  • Le AWS Toolkit vous indique qu'aucun gestionnaire correspondant ne peut être détecté avant le téléchargement.

  • Pour modifier le gestionnaire associé à votre fonction Lambda, utilisez AWS Lambda console le ou le. AWS Command Line Interface

  1. À partir de AWS Toolkit for Visual Studio Code, développez l' AWS explorateur.

  2. Dans l' AWS explorateur, développez Lambda pour afficher vos ressources Lambda.

  3. Cliquez avec le bouton droit sur la fonction Lambda vers laquelle vous souhaitez télécharger vos modifications, puis choisissez Upload Lambda... pour ouvrir le menu Sélectionner le type de téléchargement.

  4. Choisissez Directory pour passer à l'écran Build directory.

  5. Dans l'écran Créer un répertoire, choisissez Oui, puis sélectionnez un répertoire local pour le téléchargement.

  6. Lorsque vous y êtes invité, confirmez le téléchargement pour commencer à créer et à télécharger le répertoire sélectionné.

  7. L'état de votre téléchargement est affiché dans VS Code et vous êtes averti lorsque le processus de téléchargement est terminé.

Conversion de votre fonction Lambda en projet AWS SAM

Pour convertir votre fonction Lambda en AWS SAM pile, procédez comme suit.

Avertissement

Actuellement, seul un sous-ensemble de ressources est pris en charge lors de la conversion d'une fonction Lambda en AWS SAM projet. Pour localiser les ressources manquantes après une conversion, consultez la console Lambda et ajoutez-les manuellement à votre AWS SAM modèle. Pour plus de détails sur les ressources prises en charge et non prises en charge, consultez la rubrique relative à la prise en charge des types de ressources dans le Guide du AWS CloudFormation développeur.

  1. À partir de la AWS boîte à outils, développez l' AWS explorateur.

  2. Dans l' AWS explorateur, étendez la AWS région à l'aide de la fonction Lambda que vous souhaitez convertir en AWS SAM projet.

  3. Depuis la AWS région, développez Lambda et parcourez la fonction que vous souhaitez convertir en AWS SAM pile.

  4. Dans le menu rapide situé à côté de votre fonction Lambda, cliquez sur l'icône Convertir en application SAM pour parcourir votre système de fichiers local et spécifier un emplacement pour votre nouveau AWS SAM projet.

  5. Après avoir spécifié un emplacement, le AWS Toolkit commence à convertir votre fonction Lambda en AWS SAM projet, VS Code fournit des mises à jour sur l'état du processus.

    Note

    Ce processus peut prendre quelques minutes.

  6. Lorsque VS Code vous y invite, entrez un nom de pile, puis appuyez sur la Enter touche pour continuer.

  7. VS Code continue de vous informer de l'état de votre projet, puis vous avertit lorsque le processus est terminé et ouvre votre nouveau AWS SAM projet en tant qu'espace de travail VS Code.