View a markdown version of this page

Développement de fonctions Lambda localement avec VS Code - AWS Lambda
Principaux avantages du développement localConditions préalablesAuthentification et contrôle d’accèsDéplacement de la console au développement localUtilisation des fonctions localementConvertissez votre fonction en AWS SAM modéliser et utiliser 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

Bien que la console Lambda permette 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 de les déployer 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 sur les dépendances des fonctions

Conditions préalables

Avant de développer des fonctions Lambda localement dans VS Code, vous devez disposer de ce qui suit :

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 des utilisateurs IAM

  • Informations d’identification temporaires 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 d’utilisateur IAM.

Obtenir les informations d’identification IAM

Si un utilisateur IAM possède déjà des clés d’accès, préparez l’ID de 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, suivez ces étapes 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 Suivant.

  5. Pour Set permissions (Définir les autorisations), sélectionnez Attacher directement les stratégies.

  6. Sélectionnez AdministratorAccesset choisissez Next.

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

  8. Dans la bannière indiquant le succès, choisissez Voir 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 et choisissez 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 après avoir 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 AWS informations d'identification à l'aide du AWS Boîte à outils

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 ?
Ouvrez le panneau Connexion Démarrer l’authentification
Utilisez la palette de commandes, recherchez AWS Ajouter une nouvelle connexion Accédez à l’interface de connexion
Choisissez Informations d’identification IAM Utiliser vos clés d’accès pour l’accès programmatique
Saisissez le nom du profil, la clé d’accès et la clé secrète Fournir les 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 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 activé Windows/Linux), recherchez et sélectionnez Ajouter une nouvelle connexion.AWS

  2. Dans le panneau de connexion, choisissez Informations d’identification IAM, puis sélectionnez Continuer.

    Note

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

  3. Saisissez le nom de votre profil, l’ID de 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 authentifier AWS les SDK et les 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.

Déplacement 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 le code de votre 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 localement

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 voir et gérer vos fonctions :

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

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

  • Modifier le code de fonction avec prise en charge complète du langage et saisie semi-automatique du code.

  • Utilisez l'LocalStack intégration dans VS Code pour tester les fonctions Lambda qui envoient des appels d'API à d'autres personnes Services AWS pendant l'exécution, par exemple en lisant des tables DynamoDB ou en écrivant dans des compartiments Amazon S3. LocalStack est un émulateur de services cloud qui fournit un environnement de développement local complet pour tester les intégrations de services. Vous pouvez également utiliser AWS SAM CLI pour tester votre fonction dans un conteneur local. Si votre fonction fait des appels d'API à d'autres, Services AWS ces appels atteindront AWS des ressources réelles, et non des ressources émulées.

  • Déboguez votre fonction avec des points d’arrêt et l’inspection des variables. Pour plus d’informations, consultez Exécution et débogage de fonctions Lambda directement à partir du code dans le Guide de l’utilisateur AWS Toolkit for Visual Studio Code .

  • 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éliser et utiliser 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 l'emplacement AWS SAM du 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ôler la gestion des versions de votre infrastructure

  • Automatiser les déploiements

  • Déboguer les fonctions à distance

  • Ajoutez des AWS ressources supplémentaires à votre application

  • Maintenir 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 :