View a markdown version of this page

AWS Lambda avec LocalStack support - AWS Boîte à outils pour VS Code
Conditions préalablesInstallation LocalStackCon LocalStackfigurationDémarrage LocalStack dans VS CodeCréation d'un exemple d'application sans serveurTester et déboguer les fonctions Lambda avec LocalStack

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.

AWS Lambda avec LocalStack support

Créez, testez et déboguez vos applications sans serveur grâce à l' LocalStack assistance fournie dans le. AWS Toolkit for Visual Studio Code LocalStack est un émulateur AWS Cloud qui permet de tester localement des applications sans serveur.

Pour plus d'informations à ce sujet AWS Lambda, consultez le Guide du AWS Lambda développeur. Pour en savoir plus LocalStack, visitez leur site Web LocalStack.

Conditions préalables

Les conditions préalables à l'utilisation de VS Code sont LocalStack les suivantes.

Note

La LocalStack CLI est installée pendant le processus d'installation, mais si vous préférez une autre version de la LocalStack CLI, la version minimale requise est 4.8.0.

  • Un compte d'application LocalStack Web est requis pour accéder à toutes les fonctionnalités disponibles pour les LocalStack niveaux gratuits et payants. LocalStack L'édition communautaire est disponible sans compte.

  • Docker doit fonctionner avec LocalStack dans VS Code. Pour plus d'informations sur la LocalStack configuration requise pour Docker, consultez la rubrique LocalStack Docker Images dans la LocalStack documentation.

  • Recommandé : le AWS Command Line Interface (AWS CLI) vous aide à utiliser les services de votre environnement cloud simulé.

Installation LocalStack

Pour installer des versions hiérarchisées LocalStack gratuites et payantes, procédez comme suit.

Note

Pour obtenir des instructions sur LocalStack la configuration de l'édition Community, consultez le contenu de la LocalStack communauté dans la LocalStack section Configuration de cette rubrique.

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

  2. Cliquez sur le bouton Ouvrir la procédure pas à pas pour ouvrir l'onglet Commencer à créer votre application dans l'éditeur VS Code.

  3. Dans la procédure pas à pas, choisissez Installer LocalStack pour démarrer le processus LocalStack d'installation dans VS Code.

Con LocalStackfiguration

Après avoir installé l' LocalStack extension pour VS Code, l'un des indicateurs suivants peut s'afficher lorsque la configuration est requise :

  • Dans la barre d'état VS Code, située dans le coin inférieur gauche de l'IDE par défaut, l' LocalStack état est rouge.

  • VS Code vous invite à configurer. LocalStack

Il existe deux types de configuration et de configuration LocalStack, selon la version que LocalStack vous utilisez. Les sections à onglets suivantes décrivent chaque processus de LocalStack configuration.

Note

LocalStack des jetons d'authentification sont requis pour les versions gratuites et payantes de LocalStack. Pour des informations spécifiques sur la LocalStack tarification, consultez leur guide de tarification Choisissez votre plan.

Il existe deux méthodes de configuration LocalStack.

  • Dans l'invite de configuration LocalStack de VS Code pour démarrer, cliquez sur le bouton Configuration.

  • Dans la barre d'état de VS Code, choisissez l'icône d' LocalStack état pour ouvrir l'invite Configuration LocalStack pour démarrer, puis cliquez sur le bouton Configuration.

Lors de la configuration, le système suit les étapes suivantes :

  1. Installe la LocalStack CLI.

  2. Vérifie si vous avez un LocalStack compte.

  3. Si vous possédez un LocalStack compte, le système vous guide tout au long du processus d'authentification dans votre navigateur Web par défaut. De même, si vous n'avez pas de LocalStack compte, le système vous guide tout au long de la configuration du compte avant le processus d'authentification.

Une fois configuré, le LocalStack statut LocalStack est mis à jour dans la barre d'état VS Code.

Note

Si vous n'avez pas créé de AWS profil pour LocalStack, un nouveau profil est automatiquement créé pour vous dans le cadre du processus de LocalStack configuration.

L'édition Community de LocalStack est gratuite et ne nécessite pas de création de compte. Elle fonctionne à partir d'une image Docker qui ne nécessite pas de licence. Pour plus de détails sur LocalStack Community Edition, consultez la documentation relative aux images de la LocalStack communauté. Les sections suivantes décrivent les prérequis et la configuration de base requise pour utiliser l'édition LocalStack communautaire dans VS Code.

Lancer une nouvelle instance

Pour lancer une nouvelle instance de LocalStack Community, procédez comme suit.

Note

L'exemple suivant démarre une instance de conteneur LocalStack sur le port 4566. Si vous spécifiez des valeurs de port différentes, vous devez mettre à jour la valeur de port spécifiée dans la procédure située dans la section Configuration de la AWS boîte à outils AWS CLI et.

  1. Depuis VS Code, ouvrez le terminal VS Code en appuyant surctrl + `(backtick).

  2. Entrez les informations suivantes dans le terminal.

    Mac : 

    docker run -d --name localstack_main \
>> -p 4566:4566 \
>> -v /var/run/docker.sock:/var/run/docker.sock \
>> localstack/localstack

    Windows:

    docker run -d --name localstack_main `
>> -p 4566:4566 `
>> -v /var/run/docker.sock:/var/run/docker.sock `
>> localstack/localstack

  3. Le terminal est mis à jour avec l'état de votre instance Docker lorsque le processus est terminé.

Cette instance conteneurisée de vous LocalStack donne accès aux AWS services que vous avez spécifiés lors du processus de téléchargement.

Configuration de la CLI pour LocalStack et Docker.

Pour configurer la AWS boîte à outils AWS CLI et l' LocalStack utiliser dans Docker, créez un nouveau profil en suivant les étapes suivantes :

  1. Depuis VS Code, ouvrez le terminal VS Code en appuyant surctrl + `(backtick).

  2. Entrez les informations suivantes dans le terminal.

    ~/.aws/credentials
[localstack]
aws_access_key_id = test
aws_secret_access_key = test
~/.aws/config
[profile localstack]
region = us-east-1
output = json
endpoint_url = http://localhost:4566 [default localstack endpoint]

  3. Le AWS Toolkit détecte votre LocalStack profil et met à jour le menu d'état de la connexion.

Après la configuration, le choix de votre LocalStack profil AWS dans la section profil de la barre d'état rend vos LocalStack ressources visibles dans l' AWS explorateur. En outre, vous pouvez consulter vos LocalStack journaux dans l'onglet Sortie du terminal VS Code.

Démarrage LocalStack dans VS Code

Vous pouvez commencer à LocalStack utiliser l'une des méthodes suivantes :

À LocalStack partir de la barre d'état de VS Code

  1. Dans VS Code, accédez à la barre d'état, puis cliquez sur le LocalStack bouton Démarrer pour le lancer LocalStack.

  2. La barre d'état VS Code est mise à jour lorsqu'elle LocalStack est lancée avec succès.

À LocalStack partir du code VS Palette de commandes

  1. Dans VS Code, ouvrez la palette de commandes en appuyant sur Cmd + Shift + P (Mac) ou Control + Shift + P (Windows).

  2. Dans la palette de commandes, entrez Start LocalStack dans la barre de recherche et choisissez-la dans la liste lorsqu'elle apparaît dans les résultats.

  3. La barre d'état VS Code est mise à jour lorsqu'elle LocalStack est lancée avec succès.

À LocalStack partir du terminal VS Code

  1. Depuis VS Code, ouvrez le terminal VS Code en appuyant surctrl + `(backtick).

  2. Depuis le terminal VS Code, entrez la commande localstack start CLI.

  3. La barre d'état VS Code est mise à jour lorsqu'elle LocalStack est lancée avec succès.

Création d'un exemple d'application sans serveur

Pour commencer à travailler LocalStack dans VS Code, vous avez besoin d'un exemple d'application sans serveur. Si vous avez déjà une application existante dans votre AWS compte, vous pouvez la déployer localement à l'aide de Serverless Land LocalStack ou en créer une nouvelle avec AWS Serverless Land.

Pour plus d'informations sur la création d'une application avec Serverless Land dans la AWS boîte à outils, consultez la rubrique Utilisation de AWS Serverless Land dans ce guide de l'utilisateur. Pour des informations détaillées sur Serverless Land, consultez la page d'accueil principale de l'application Web Serverless Land.

Tester et déboguer les fonctions Lambda avec LocalStack

Tester et déboguer vos fonctions Lambda dans l'extension LocalStack VS Code revient à travailler avec vos fonctions déployées dans le AWS cloud. La principale différence est que votre instance AWS Toolkit doit être authentifiée auprès de votre LocalStack compte pour déployer et déboguer vos fonctions. LocalStack

Note

Les fonctionnalités de test et de débogage décrites dans cette section ne sont pas disponibles pour l'édition LocalStack Community.

Pour travailler avec LocalStack VS Code, connectez-vous à votre LocalStack profil dans la AWS boîte à outils. Lorsque votre LocalStack profil est actif, la barre d'état de VS Code affiche AWS : profile:localstack (point de terminaison personnalisé) avec une coche.

Pour obtenir des informations détaillées sur l'utilisation de vos fonctions Lambda dans le AWS Toolkit, consultez la rubrique Utilisation des AWS Lambda fonctions de ce guide de l'utilisateur.