View a markdown version of this page

Déboguer à distance des fonctions Lambda avec Visual Studio Code - AWS Lambda
Environnements d'exécution pris en chargeSécurité et débogage à distanceConditions préalablesDébogage à distance de fonctions LambdaDésactiver le débogage à distanceInformations supplémentaires

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.

Déboguer à distance des fonctions Lambda avec Visual Studio Code

Grâce à la fonction de débogage à distance du AWS Toolkit for Visual Studio Code, vous pouvez déboguer vos fonctions Lambda exécutées directement dans le cloud. AWS Cela est utile lorsque vous étudiez des problèmes difficiles à reproduire localement ou à diagnostiquer uniquement à l’aide de journaux.

Grâce au débogage à distance, vous pouvez :

  • Définir des points d’arrêt dans le code de votre fonction Lambda.

  • Exécuter le code étape par étape en temps réel.

  • Inspecter les variables et leur état pendant l’exécution.

  • Déboguez les fonctions Lambda déployées AWS, y compris celles situées dans des VPC ou dotées d'autorisations IAM spécifiques.

Environnements d'exécution pris en charge

Le débogage à distance est pris en charge pour les environnements d’exécution suivants :

  • Python (AL2023)

  • Java

  • JavaScript/Node.js (ANNÉE 2023)

Note

Le débogage à distance est pris en charge pour les architectures x86_64 et arm64.

Sécurité et débogage à distance

Le débogage à distance fonctionne dans les limites de sécurité Lambda existantes. Les utilisateurs peuvent associer des couches à une fonction à l’aide de l’autorisation UpdateFunctionConfiguration, qui permet déjà d’accéder aux variables d’environnement et à la configuration de la fonction. Le débogage à distance ne s’étend pas au-delà de ces autorisations existantes. Il ajoute plutôt des contrôles de sécurité supplémentaires grâce à un tunneling sécurisé et à une gestion automatique des sessions. En outre, le débogage à distance est une fonctionnalité entièrement contrôlée par le client nécessitant des autorisations et des actions explicites :

  • Création d'un tunnel IoT sécurisé  : La AWS boîte à outils doit créer un tunnel IoT sécurisé, qui ne se produit qu'avec l'autorisation explicite de l'utilisateuriot:OpenTunnel.

  • Attachement de la couche de débogage et gestion des jetons : le processus de débogage assure la sécurité via les contrôles suivants :

    • La couche de débogage doit être attachée à la fonction Lambda, et ce processus nécessite les autorisations suivantes : lambda:UpdateFunctionConfiguration et lambda:GetLayerVersion.

    • Mettez à jour le jeton de sécurité (généré viaiot:OpenTunnel) dans la variable d'environnement de la fonction avant chaque session de débogage. Cette étape nécessite égalementlambda:UpdateFunctionConfiguration.

    • Pour des raisons de sécurité, ce jeton est automatiquement pivoté, et la couche de débogage est automatiquement supprimée à la fin de chaque session de débogage et ne peut pas être réutilisée.

Note

Le débogage à distance est pris en charge pour les architectures x86_64 et arm64.

Conditions préalables

Avant de commencer le débogage à distance, vérifiez que vous disposez des éléments suivants :

  1. Fonction Lambda déployée sur votre AWS compte.

  2. AWS Toolkit for Visual Studio Code. Consultez Configuration d’ AWS Toolkit for Visual Studio Code pour les instructions d’installation.

  3. La version du AWS Toolkit que vous avez installée est 3.69.0 ou ultérieure.

  4. AWS informations d'identification configurées dans AWS Toolkit for Visual Studio Code. Pour de plus amples informations, veuillez consulter Authentification et contrôle d’accès.

Débogage à distance de fonctions Lambda

Pour démarrer une session de débogage à distance, procédez comme suit :

  1. Ouvrez l' AWS explorateur dans VS Code en sélectionnant l' AWS icône dans la barre latérale gauche.

  2. Développez la section Lambda pour voir vos fonctions.

  3. Ouvrez le menu contextuel de la fonction que vous souhaitez déboguer.

  4. Dans le menu contextuel, sélectionnez Invoquer à distance.

  5. Dans la fenêtre d’invocation qui s’ouvre, cochez la case Activer le débogage.

  6. Cliquez sur Invoquer pour démarrer la session de débogage à distance.

Note

Les fonctions Lambda ont une limite combinée de 250 Mo pour le code de fonction et toutes les couches associées. La couche de débogage à distance ajoute environ 40 Mo à la taille de votre fonction.

Une session de débogage à distance se termine quand vous :

  • Choisissez Supprimer la configuration de débogage sur l’écran de configuration de l’invocation à distance.

  • Sélectionnez l’icône de déconnexion dans les commandes de débogage de VS Code.

  • Sélectionnez le fichier de gestionnaire dans l’éditeur VS Code.

Note

La couche de débogage est automatiquement supprimée après 60 secondes d’inactivité après votre dernière invocation.

Désactiver le débogage à distance

Vous pouvez désactiver cette fonctionnalité de trois manières :

  • Refuser les mises à jour de fonction : définissez lambda:UpdateFunctionConfiguration sur deny.

  • Restreindre les autorisations IoT  : refuser IoT-related les autorisations

  • Bloquer les couches de débogage : refusez lambda:GetLayerVersion pour les ARN suivants :

    • arn:aws:lambda:*:*:layer:LDKLayerX86:*

    • arn:aws:lambda:*:*:layer:LDKLayerArm64:*

    Note

    La désactivation de cette fonctionnalité empêche l’ajout de la couche de débogage lors des mises à jour de configuration des fonctions.

Pour plus d’informations sur l’utilisation de Lambda dans VS Code, reportez-vous à la section Développement de fonctions Lambda localement avec VS Code.

Pour obtenir des instructions détaillées sur le dépannage, les cas d'utilisation avancés et la disponibilité des régions, consultez la section Débogage à distance des fonctions Lambda dans le Guide de l' AWS Toolkit for Visual Studio Code utilisateur.