AWS Lambda avec LocalStack support

Créez, testez et déboguez vos applications sans serveur avec le LocalStack support du. 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 Lambdadéveloppeur. Pour en savoir plus LocalStack, visitez leur site Web LocalStack.

Prérequis

Les conditions suivantes sont requises pour travailler avec LocalStack VS Code.

Note

La LocalStack CLI est installée pendant le processus de configuration, mais si vous préférez une version différente 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 gratuit et payant. LocalStack l'édition communautaire est disponible sans compte.

• Docker doit être utilisé LocalStack dans VS Code. Pour plus d'informations sur les LocalStack exigences relatives à Docker, consultez la rubrique Images LocalStack Docker dans la LocalStack documentation.

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

Installation LocalStack

Pour installer des versions à plusieurs niveaux LocalStack gratuites et payantes, procédez comme suit.

Note

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

1. À partir du AWS kit d'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, vous pouvez voir l'un des indicateurs suivants lorsque l'installation est nécessaire :

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

• VS Code vous invite à le configurer. LocalStack

Il existe deux types d'installation et de configuration pour 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 obtenir des informations spécifiques sur LocalStack les tarifs, consultez leur guide de tarification Choisissez votre plan.

LocalStack niveaux gratuits et payants

Il existe deux méthodes de configuration LocalStack.

• À partir de l'invite LocalStack de configuration 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 LocalStack de configuration pour démarrer, puis cliquez sur le bouton Configuration.

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

1. Installe la LocalStack CLI.

2. Vérifie si tu as un LocalStack compte.

3. Si vous avez 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 la configuration terminée, le LocalStack statut LocalStack est mis à jour dans la barre d'état de VS Code.

Note

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

LocalStack Communauté

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 l'édition LocalStack communautaire, consultez la documentation sur les images LocalStack communautaires. Les sections suivantes décrivent les prérequis et la configuration de base requise pour fonctionner avec l'édition LocalStack communautaire dans VS Code.

Lancement d'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 du kit d' AWS outils AWS CLI et du kit d'outils.

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

2. Entrez ce qui suit 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 une fois le processus 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 le AWS kit d'outils AWS CLI et l'utiliser LocalStack dans Docker, configurez un nouveau profil en effectuant les étapes suivantes :

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

2. Entrez ce qui suit 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. De plus, vous pouvez consulter vos LocalStack journaux dans l'onglet Sortie du terminal VS Code.

Commencer LocalStack dans VS Code

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

À LocalStack partir de la barre d'état du code VS

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

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

À LocalStack partir de la palette de commandes VS Code

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 du code VS est mise à jour lorsqu'elle LocalStack a été 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. À partir du terminal VS Code, entrez la commande localstack start CLI.

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

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

Pour commencer à travailler avec LocalStack 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 en utilisant LocalStack ou vous pouvez créer une nouvelle application avec AWS Serverless Land.

Pour plus d'informations sur la création d'une application avec Serverless Land dans le AWS kit d'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.

Test et débogage des fonctions Lambda avec LocalStack

Le test et le débogage de vos fonctions Lambda dans LocalStack l'extension VS Code sont similaires à l'utilisation de vos fonctions déployées dans le cloud. AWS La principale différence est que votre instance AWS Toolkit doit être authentifiée avec 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 communautaire.

Pour travailler avec LocalStack VS Code, connectez-vous à votre LocalStack profil dans le AWS Toolkit. 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 kit d'outils, consultez la rubrique Utilisation des AWS Lambda fonctions de ce guide de l'utilisateur.