AWS Lambda débogage à distance

Accès au débogage à distance Lambda depuis l'explorateur AWS

1. Depuis VS Code, ouvrez l'extension AWS Toolkit.

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

3. Depuis l'explorateur, développez le nœud Lambda.

4. Accédez à la fonction que vous souhaitez déboguer, puis choisissez l'icône Invoke remote dans le menu contextuel pour ouvrir l'écran de configuration de Remote Invoke.

Accès au débogage à distance Lambda depuis l'explorateur Application Builder.

1. Depuis VS Code, ouvrez l'extension AWS Toolkit.

2. À partir du AWS kit d'outils, développez l'explorateur du générateur d'applications.

3. À partir de l'explorateur, développez le AWS SAM projet qui contient le projet Lambda que vous souhaitez déboguer.

4. Développez la Lambda fonction déployée que vous souhaitez déboguer.

5. Accédez à la fonction Remote, puis choisissez l'icône Invoke remote dans le menu contextuel pour ouvrir l'écran de configuration de Remote Invoke.

1. Ouvrez le menu de configuration de l'appel à distance en exécutant la procédure Accès au débogage à distance Lambda depuis l' AWS explorateur ou la procédure Accès au débogage à distance Lambda depuis l'explorateur Application Builder, présentée dans la section précédente.

2. Dans le menu de configuration de l'appel à distance, cochez la case Débogage à distance pour afficher les propriétés de débogage à distance.

3. Spécifiez le chemin racine local vers votre fichier de gestionnaire local.

   Note

   Le chemin racine local est l'emplacement de votre code source qui correspond à la fonction Lambda déployée. Si vous travaillez à partir d'une fonction déployée dans l'explorateur Application Builder, votre chemin racine local est automatiquement détecté.

   Si le code source n'est pas stocké localement, cliquez sur le bouton Télécharger le code à distance pour récupérer le code source de votre fonction Lambda. Cela vous ouvrira handler file dans l'éditeur de code VS.

4. Dans la section Charge utile, spécifiez où les données de vos événements de test sont obtenues.

1. handler fileDans l'éditeur VS Code, cliquez dans la marge de la gouttière pour définir des points d'arrêt aux numéros de ligne où vous souhaitez suspendre le débogage.

2. Lorsque vous êtes satisfait des points d'arrêt, retournez dans le menu de configuration de l'appel à distance pour vérifier que vos paramètres sont correctement configurés, puis cliquez sur le bouton d'appel à distance pour démarrer le débogage.

3. Le AWS Toolkit met à jour votre fonction Lambda avec des fonctionnalités de débogage, établit un tunnel sécurisé pour la session de débogage, appelle votre fonction avec la charge utile spécifiée, puis suspend le processus lorsqu'il atteint un point d'arrêt.

4. Lors d'une pause, utilisez le volet RUN AND DEBUG pour afficher vos VARIABLES, CALL STACK et BREAKPOINTS.

1. Lorsque votre session de débogage est active, apportez des modifications handler file dans l'éditeur VS Code.

2. Enregistrez vos modifications (Command+S on macOS,Ctrl+S on Windows)

3. Lorsque vous y êtes invité, confirmez que vous souhaitez procéder au déploiement de vos modifications. Le AWS kit d'outils mettra à jour votre fonction Lambda avec le code modifié.

4. Poursuivez le débogage et testez vos modifications en définissant de nouveaux points d'arrêt et en sélectionnant à nouveau le bouton d'appel à distance.

   Note

   Vous pouvez également désélectionner l'option Attacher le débogueur dans les commandes de débogage de VS Code et choisir le bouton Remote Invoke pour exécuter votre fonction sans déboguer.

1. À partir du débogage à distance Lambda dans le AWS Toolkit, développez la section de configuration supplémentaire du débogage à distance.

2. Dans la section Configuration supplémentaire du débogage à distance, copiez l'ARN de votre couche de région à partir du champ Layer override.

3. À partir du AWS CLI, utilisez la commande suivante pour télécharger la version de la coucheaws lambda get-layer-version-by-arn --arn layer-arn, en remplaçant layer-arn par l'ARN de votre couche. Pour obtenir des instructions détaillées sur le téléchargement de la couche de débogage signée, consultez la référence get-layer-version-by-arn dans la référence des AWS CLI commandes.

4. Signez la couche avec votre configuration de signature de code et publiez-la sur votre compte. Pour obtenir des conseils de signature et de publication, consultez la rubrique Configurer la signature de code pour votre AWS SAM application dans le Guide du AWS Serverless Application Model développeur.

5. Une fois la couche signée et publiée sur votre compte, retournez à la section Configuration supplémentaire du débogage à distance de Lambda Remote Debug, puis entrez le nouvel ARN de couche dans le champ Layer override. Lorsque le processus est terminé, le débogage à distance Lambda utilise votre couche signée au lieu de la couche par défaut.

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

2. Depuis l'explorateur, développez le nœud Lambda.

3. Accédez à la fonction pour laquelle vous souhaitez effectuer la configuration TypeScript, puis choisissez l'icône Invoquer à distance dans le menu contextuel pour ouvrir l'écran de configuration de l'appel à distance.

4. Activez le débogage à distance en cochant la case Débogage à distance.

5. Configurez votre chemin racine local en pointant sur le répertoire contenant votreTypeScript handler file.

   Note

   TypeScript handler fileC'est là que vous définissez vos points d'arrêt de débogage.

6. Étendez les paramètres de configuration supplémentaires du débogage à distance.

7. Activez le mappage des sources en cochant la case Carte des sources.

8. Définissez le champ Fichiers sortants sur le répertoire local de votre copie de fonction Lambda.

   Si app.js et app.map sont entrés.aws-sam/build/HelloWorldFunction, définissez l'emplacement des fichiers de sortie/Users/user/project/aws-sam/build/HelloWorldFunction/*.

   Note

   Le chemin du fichier de sortie doit être un chemin absolu.

9. Lorsque vous êtes satisfait des paramètres, cliquez sur le bouton Remote Invoke pour commencer à déboguer votre TypeScript fonction.