AWS Lambda mit LocalStack Unterstützung

Erstellen, testen und debuggen Sie Ihre serverlosen Anwendungen mit LocalStack Unterstützung in der AWS Toolkit for Visual Studio Code. LocalStack ist ein AWS Cloud-Emulator, der das lokale Testen von serverlosen Anwendungen ermöglicht.

Weitere Informationen dazu AWS Lambda finden Sie im AWS Lambda Entwicklerhandbuch. Um mehr darüber zu erfahren LocalStack, besuchen Sie deren Website LocalStack.

Voraussetzungen

Im Folgenden sind die Voraussetzungen für die Arbeit LocalStack in VS Code aufgeführt.

Anmerkung

Die LocalStack CLI wird während des Einrichtungsvorgangs installiert. Wenn Sie jedoch eine andere Version der LocalStack CLI bevorzugen, ist die erforderliche Mindestversion 4.8.0.

• Für den Zugriff auf alle Funktionen der kostenlosen und kostenpflichtigen LocalStack Tarife ist ein LocalStack Webanwendungskonto erforderlich. LocalStack Die Community Edition ist ohne Konto verfügbar.

• Docker ist erforderlich, um LocalStack in VS Code zu arbeiten. Weitere Informationen zu den LocalStack Anforderungen für Docker finden Sie im Thema LocalStack Docker Images in der Dokumentation. LocalStack

• Empfohlen: Das AWS Command Line Interface (AWS CLI) unterstützt Sie bei der Arbeit mit Diensten in Ihrer simulierten Cloud-Umgebung.

Installieren LocalStack

Gehen Sie wie folgt vor, um LocalStack kostenlose und kostenpflichtige mehrstufige Versionen zu installieren.

Anmerkung

Anweisungen zum Einrichten der LocalStack Community Edition finden Sie in den LocalStack Community-Inhalten im LocalStack Abschnitt Einrichtung dieses Themas.

1. Erweitern Sie im AWS Toolkit den APPLICATION BUILDER Explorer.

2. Wählen Sie die Schaltfläche Walkthrough öffnen, um im VS Code-Editor die Registerkarte Erste Schritte beim Erstellen Ihrer Anwendung zu öffnen.

3. Wählen Sie in der exemplarischen Vorgehensweise die Option Installieren aus, LocalStack um den LocalStack Installationsvorgang in VS Code zu starten.

Einrichten LocalStack

Nachdem Sie die LocalStack Erweiterung für VS Code installiert haben, wird möglicherweise eine der folgenden Anzeigen angezeigt, wenn eine Einrichtung erforderlich ist:

• In der VS Code-Statusleiste, die sich standardmäßig in der unteren linken Ecke der IDE befindet, ist der LocalStack Status rot.

• VS Code fordert Sie zur Einrichtung auf. LocalStack

Es gibt zwei Arten der Einrichtung und Konfiguration für LocalStack, je nachdem, welche Version von LocalStack Sie verwenden. In den folgenden Abschnitten mit Registerkarten wird jeder LocalStack Einrichtungsvorgang beschrieben.

Anmerkung

LocalStack Authentifizierungstoken sind für die kostenlose und die kostenpflichtige Tierversion von erforderlich. LocalStack Spezifische Informationen zur LocalStack Preisgestaltung finden Sie in der Preisübersicht „Wählen Sie Ihren Tarif“.

LocalStack kostenlose und kostenpflichtige Tarife

Es gibt 2 Möglichkeiten zur Einrichtung LocalStack.

• Wählen Sie in der Eingabeaufforderung VS Code Setup LocalStack to get started die Schaltfläche Setup.

• Wählen Sie in der VS Code-Statusleiste das LocalStack Statussymbol, um die Aufforderung Setup LocalStack zu öffnen, um loszulegen, und wählen Sie dann die Schaltfläche Setup.

Während der Einrichtung durchläuft das System die folgenden Schritte:

1. Installiert die LocalStack CLI.

2. Überprüft, ob Sie ein LocalStack Konto haben.

3. Wenn Sie ein LocalStack Konto haben, führt Sie das System durch den Authentifizierungsprozess in Ihrem Standard-Webbrowser. Ebenso führt Sie das System vor dem Authentifizierungsprozess durch die Kontoeinrichtung, wenn Sie kein Konto haben. LocalStack

Nach der Einrichtung LocalStack wird der LocalStack Status in der VS Code-Statusleiste aktualisiert.

Anmerkung

Wenn Sie kein AWS Profil für erstellt haben LocalStack, wird im Rahmen des LocalStack Einrichtungsvorgangs automatisch ein neues für Sie erstellt.

LocalStack Gemeinschaft

Die Community-Edition von LocalStack ist kostenlos und erfordert keine Registrierung für ein Konto. Sie wird von einem Docker-Image aus ausgeführt, für das keine Lizenz erforderlich ist. Weitere Informationen zur LocalStack Community Edition finden Sie in der LocalStack Community-Image-Dokumentation. In den folgenden Abschnitten werden die Voraussetzungen und die grundlegende Einrichtung beschrieben, die für die Arbeit mit der LocalStack Community Edition in VS Code erforderlich ist.

Eine neue Instanz starten

Gehen Sie wie folgt vor, um eine neue LocalStack Community-Instanz zu starten.

Anmerkung

Das folgende Beispiel startet eine Container-Instance von LocalStack auf Port 4566. Wenn Sie unterschiedliche Portwerte angeben, müssen Sie den Port-Wert aktualisieren, der in dem Verfahren im Abschnitt Konfiguration von AWS CLI und AWS Toolkit angegeben ist.

1. Öffnen Sie in VS Code das VS Code-Terminal, indem Sie auf Folgendes drückenctrl + `(backtick).

2. Geben Sie Folgendes in das Terminal ein.

   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. Das Terminal wird mit dem Status Ihrer Docker-Instanz aktualisiert, wenn der Vorgang abgeschlossen ist.

Diese containerisierte Instanz von LocalStack bietet Ihnen Zugriff auf die AWS Dienste, die Sie während des Download-Vorgangs angegeben haben.

Konfiguration der CLI für LocalStack und Docker.

Um das AWS CLI und AWS Toolkit für die Arbeit LocalStack in Docker zu konfigurieren, richten Sie ein neues Profil ein, indem Sie die folgenden Schritte ausführen:

1. Öffnen Sie in VS Code das VS Code-Terminal, indem Sie auf Folgendes drücken. ctrl + `(backtick)

2. Geben Sie Folgendes in das Terminal ein.

   ~/.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. Das AWS Toolkit erkennt Ihr LocalStack Profil und aktualisiert das Verbindungsstatusmenü.

Nach der Einrichtung werden Ihre LocalStack LocalStack Ressourcen im AWS Explorer sichtbar, wenn Sie Ihr AWS Profil im Profilbereich der Statusleiste auswählen. Darüber hinaus können Sie Ihre LocalStack Protokolle auf der Registerkarte Ausgabe des VS Code-Terminals einsehen.

Beginnend LocalStack in VS Code

Sie können LocalStack mit einer der folgenden Methoden beginnen:

Ausgehend LocalStack von der VS Code-Statusleiste

1. Navigieren Sie in VS Code zur Statusleiste und wählen Sie dann die LocalStack Schaltfläche Start, um zu starten LocalStack.

2. Die VS Code-Statusleiste wird aktualisiert, wenn sie erfolgreich gestartet LocalStack wurde.

Ausgehend LocalStack vom VS Code Befehlspalette

1. Öffnen Sie in VS Code die Befehlspalette, indem Sie Cmd + Shift + P (Mac) oder Control + Shift + P (Windows) drücken.

2. Geben Sie Start LocalStack in der Befehlspalette in die Suchleiste ein und wählen Sie sie aus der Liste aus, wenn sie in den Ergebnissen angezeigt wird.

3. Die VS Code-Statusleiste wird aktualisiert, wenn sie erfolgreich gestartet LocalStack wurde.

Ausgehend LocalStack vom VS Code-Terminal

1. Öffnen Sie im VS Code das VS Code-Terminal, indem Sie auf Folgendes drückenctrl + `(backtick).

2. Geben Sie im VS Code-Terminal den localstack start CLI-Befehl ein.

3. Die VS Code-Statusleiste wird aktualisiert, wenn sie erfolgreich gestartet LocalStack wurde.

Erstellen einer serverlosen Beispielanwendung

Um mit der Arbeit LocalStack in VS Code zu beginnen, benötigen Sie eine serverlose Beispielanwendung. Wenn Sie bereits eine vorhandene Anwendung in Ihrem AWS Konto haben, können Sie sie lokal mit AWS Serverless Land bereitstellen LocalStack oder eine neue Anwendung erstellen.

Weitere Informationen zum Erstellen einer Anwendung mit Serverless Land im AWS Toolkit finden Sie im Thema Arbeiten mit AWS Serverless Land in diesem Benutzerhandbuch. Ausführliche Informationen zu Serverless Land finden Sie auf der Hauptseite der Serverless Land-Webanwendung.

Testen und Debuggen von Lambda-Funktionen mit LocalStack

Das Testen und Debuggen Ihrer Lambda-Funktionen in der LocalStack VS Code-Erweiterung ähnelt der Arbeit mit Ihren in der Cloud bereitgestellten Funktionen. AWS Der Hauptunterschied besteht darin, dass Ihre AWS Toolkit-Instanz mit Ihrem LocalStack Konto authentifiziert werden muss, um Ihre Funktionen bereitzustellen und zu debuggen. LocalStack

Anmerkung

Die in diesem Abschnitt beschriebenen Test- und Debugging-Funktionen sind für LocalStack die Community Edition nicht verfügbar.

Um LocalStack in VS Code zu arbeiten, stellen Sie eine Verbindung zu Ihrem LocalStack Profil im AWS Toolkit her. Wenn Ihr LocalStack Profil aktiv ist, wird in der VS Code-Statusleiste Folgendes angezeigt AWS: profile:localstack (benutzerdefinierter Endpunkt) mit einem Häkchen.

Detaillierte Informationen zur Arbeit mit Ihren Lambda-Funktionen im AWS Toolkit finden Sie im Thema Arbeiten mit AWS Lambda Funktionen in diesem Benutzerhandbuch.