Développement de fonctions Lambda localement avec VS Code - AWS Lambda
Principaux avantages du développement localPrérequisAuthentification et contrôle d’accèsPasser de la console au développement localUtilisation des fonctions en localConvertissez votre fonction en AWS SAM modèle et utilisez les outils IaCÉtapes suivantes

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éveloppement de fonctions Lambda localement avec VS Code

Vous pouvez déplacer vos fonctions Lambda de la console Lambda vers Visual Studio Code, qui fournit un environnement de développement complet et vous permet d'utiliser d'autres options de développement locales telles que et. AWS SAM AWS CDK

Principaux avantages du développement local

Alors que la console Lambda permet de modifier et de tester rapidement des fonctions, le développement local offre des fonctionnalités plus avancées :

  • Fonctionnalités avancées de l'IDE : outils de débogage, de complétion de code et de refactorisation

  • Développement hors ligne : travaillez et testez les modifications localement avant le déploiement dans le cloud

  • Intégration de l'infrastructure en tant que code : utilisation fluide avec AWS SAM et Infrastructure Composer AWS CDK

  • Gestion des dépendances : contrôle total des dépendances entre les fonctions

Prérequis

Avant de développer des fonctions Lambda localement dans VS Code, vous devez avoir :

Note

Si vous avez déjà configuré un AWS compte et un profil localement, assurez-vous que la politique AdministratorAccess gérée est ajoutée à votre AWS profil configuré.

Authentification et contrôle d’accès

Pour développer des fonctions Lambda localement, vous avez besoin AWS d'informations d'identification pour accéder aux AWS ressources en toute sécurité et les gérer en votre nom, comme elles le feraient dans le cloud. Le AWS Toolkit for VS Code prend en charge les méthodes d'authentification suivantes :

Le AWS Toolkit for VS Code prend en charge les méthodes d'authentification suivantes :

  • Informations d'identification à long terme de l'utilisateur IAM

  • Informations d'identification temporaires provenant de rôles assumés

  • Fédération des identités

  • AWS informations d'identification de l'utilisateur root du compte (non recommandé)

Cette section vous explique comment obtenir et configurer ces informations d'identification à l'aide des informations d'identification à long terme de l'utilisateur IAM.

Obtenir des informations d'identification IAM

Si un utilisateur IAM possède déjà des clés d'accès, préparez l'ID de la clé d'accès et la clé d'accès secrète pour la section suivante. Si vous ne possédez pas ces clés, procédez comme suit pour les créer :

Note

Vous devez utiliser à la fois l'ID de la clé d'accès et la clé d'accès secrète pour authentifier vos demandes.

Pour créer un utilisateur IAM et des clés d'accès :

  1. Ouvrez la console IAM à l'adresse https://console.aws.amazon.com/iam/

  2. Dans le panneau de navigation, choisissez utilisateurs.

  3. Choisissez Create user (Créer un utilisateur).

  4. Dans Nom d'utilisateur, entrez un nom et choisissez Next.

  5. Sous Définir les autorisations, choisissez Joindre directement les politiques.

  6. Sélectionnez AdministratorAccesset choisissez Next.

  7. Choisissez Create user (Créer un utilisateur).

  8. Dans le bandeau de réussite, choisissez Afficher l'utilisateur.

  9. Choisissez Create access key (Créer une clé d’accès).

  10. Pour Cas d'utilisation, sélectionnez Code local.

  11. Cochez la case de confirmation, puis cliquez sur Suivant.

  12. (Facultatif) Entrez une valeur de balise de description.

  13. Choisissez Create access key (Créer une clé d’accès).

  14. Copiez immédiatement votre clé d'accès et votre clé d'accès secrète. Vous ne pourrez plus accéder à la clé d'accès secrète une fois que vous aurez quitté cette page.

Important

Ne partagez jamais votre clé secrète et ne la confiez jamais au contrôle de source. Stockez ces clés en toute sécurité et supprimez-les lorsqu'elles ne sont plus nécessaires.

Note

Pour plus d'informations, consultez les sections Créer un utilisateur IAM dans votre AWS compte et Gérer les clés d'accès pour les utilisateurs IAM dans le guide de l'utilisateur IAM.

Configurer les AWS informations d'identification à l'aide du AWS kit d'

Le tableau suivant récapitule le processus de configuration des informations d'identification que vous allez effectuer dans le cadre de la procédure suivante.

Que faire Pourquoi ?
Ouvrir le panneau de connexion Démarrer l’authentification
Utilisez la palette de commandes, recherchez AWS Ajouter une nouvelle connexion Accédez à l'interface utilisateur de connexion
Choisissez IAM Credential Utilisez vos clés d'accès pour un accès programmatique
Entrez le nom du profil, la clé d'accès, la clé secrète Fournir des informations d'identification pour la connexion
Voir la mise à jour de AWS Explorer Confirmez que vous êtes connecté

Effectuez les étapes suivantes pour vous authentifier auprès de votre AWS compte :

  1. Ouvrez le panneau de connexion dans VS Code :

    1. Pour démarrer le processus d'authentification, sélectionnez l' AWS icône dans le volet de navigation de gauche ou ouvrez la palette de commandes (Cmd+Shift+P sur Mac ou Ctrl+Shift+P sur Windows/Linux), recherchez et sélectionnez Ajouter une nouvelle connexion.AWS

  2. Dans le panneau de connexion, choisissez IAM Credentials, puis sélectionnez Continuer.

    Note

    Pour continuer, vous devez autoriser les extensions AWS IDE pour VS Code à accéder à vos données.

  3. Entrez le nom de votre profil, l'identifiant de la clé d'accès et la clé d'accès secrète, puis sélectionnez Continuer.

  4. Vérifiez la connexion en vérifiant l' AWS explorateur dans VS Code pour vos AWS services et ressources.

Pour plus d'informations sur la configuration de l'authentification avec des informations d'identification à long terme, voir Utilisation d'informations d'identification à long terme pour l'authentification AWS SDKs et outils.

Pour plus d'informations sur la configuration de l'authentification, consultez les informations d'identification AWS IAM dans le guide de AWS Toolkit for Visual Studio Code l'utilisateur.

Passer de la console au développement local

Note

Si vous avez apporté des modifications à la console, assurez-vous qu'il n'y a aucune modification non déployée avant de passer au développement local.

Pour déplacer une fonction Lambda de la console Lambda vers VS Code, procédez comme suit :

  1. Ouvrez la console Lambda.

  2. Choisissez le nom de votre fonction .

  3. Sélectionnez l'onglet Source du code.

  4. Choisissez Ouvrir dans Visual Studio Code.

    Note

    Le bouton Ouvrir dans Visual Studio Code n'est disponible que dans les versions 3.69.0 et ultérieures du AWS Toolkit. Si une version antérieure du AWS Toolkit est installée, un Cannot open the handler message peut s'afficher dans VS Code. Pour résoudre ce problème, mettez à jour votre AWS boîte à outils avec la dernière version.

  5. Lorsque vous y êtes invité, autorisez votre navigateur à ouvrir VS Code.

Lorsque vous ouvrez votre fonction dans VS Code, Lambda crée un projet local avec votre code de fonction dans un emplacement temporaire conçu pour des tests et un déploiement rapides. Cela inclut le code de fonction, les dépendances et une structure de projet de base que vous pouvez utiliser pour le développement local.

Pour plus de détails sur l'utilisation AWS dans VS Code, consultez le guide de AWS Toolkit for Visual Studio Code l'utilisateur.

Utilisation des fonctions en local

Après avoir ouvert votre fonction dans VS Code, suivez ces étapes pour accéder à vos fonctions et les gérer :

  1. Sélectionnez l' AWS icône dans la barre latérale pour ouvrir l' AWS explorateur :

    AWS Icône du kit d'outils dans la barre latérale de VS Code

  2. Dans l' AWS explorateur, sélectionnez la région dans laquelle se trouve votre fonction Lambda :

    AWS Explorateur affichant la sélection de régions

  3. Dans la région que vous avez sélectionnée, développez la section Lambda pour afficher et gérer vos fonctions :

    Fonctions Lambda avec icônes d'action pour le déploiement, l'appel, etc.

Une fois votre fonction ouverte dans VS Code, vous pouvez :

  • Modifiez le code de fonction avec prise en charge complète du langage et complétez le code.

  • Testez votre fonction localement à l'aide du AWS Toolkit.

  • Déboguez votre fonction avec des points d'arrêt et une inspection des variables.

  • Déployez à nouveau votre fonction mise à jour AWS en utilisant l'icône du cloud.

  • Installez et gérez les dépendances de votre fonction.

Pour plus d'informations, consultez la section Utilisation des fonctions AWS Lambda dans le guide de l' AWS Toolkit for Visual Studio Code utilisateur.

Convertissez votre fonction en AWS SAM modèle et utilisez les outils IaC

Dans VS Code, vous pouvez convertir votre fonction Lambda en AWS SAM modèle en choisissant l'icône Convertir en AWS SAM application à côté de votre fonction Lambda. Vous serez invité à sélectionner un emplacement pour AWS SAM le projet. Une fois sélectionnée, votre fonction Lambda sera convertie en un template.yaml fichier enregistré dans votre nouveau AWS SAM projet.

Une fois votre fonction convertie en AWS SAM modèle, vous pouvez :

  • Contrôlez le versionnement de votre infrastructure

  • Automatisez les déploiements

  • Fonctions de débogage à distance

  • Ajoutez des AWS ressources supplémentaires à votre application

  • Maintenez des environnements cohérents tout au long de votre cycle de développement

  • Utilisez Infrastructure Composer pour modifier visuellement votre AWS SAM modèle

Pour plus d'informations sur l'utilisation des outils IaC, consultez les guides suivants :

Ces outils fournissent des fonctionnalités supplémentaires pour définir, tester et déployer vos applications sans serveur.

Étapes suivantes

Pour en savoir plus sur l'utilisation des fonctions Lambda dans VS Code, consultez les ressources suivantes :