AWS Lambda mit LocalStack Unterstützung

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

Weitere Informationen zu AWS Lambda finden Sie im AWS LambdaEntwicklerhandbuch. Um mehr darüber zu erfahren LocalStack, besuchen Sie ihre Website LocalStack.

Voraussetzungen

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

Anmerkung

Die LocalStack CLI wird während des Einrichtungsvorgangs installiert, aber wenn Sie eine andere Version der LocalStack CLI bevorzugen, ist die mindestens erforderliche Version 4.8.0.

• Für den Zugriff auf alle Funktionen, die in den kostenlosen und kostenpflichtigen LocalStack Tarifen verfügbar sind, ist ein LocalStack Webanwendungskonto erforderlich. LocalStack Die Community Edition ist ohne Konto verfügbar.

• Docker ist erforderlich, um mit LocalStack VS Code arbeiten zu können. 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.

Installation LocalStack

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

Anmerkung

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

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

2. Wählen Sie die Schaltfläche Exemplarische Vorgehensweise öffnen, um die Registerkarte Erste Schritte beim Erstellen Ihrer Anwendung im VS Code-Editor 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 werden die einzelnen LocalStack Einrichtungsvorgänge beschrieben.

Anmerkung

LocalStack Authentifizierungstoken sind für die kostenlosen und kostenpflichtigen Tierversionen von erforderlich. LocalStack Spezifische Informationen zu den LocalStack Preisen finden Sie in der Preisübersicht „Wählen Sie Ihren Tarif“.

LocalStack kostenlose und kostenpflichtige Stufen

Es gibt zwei Möglichkeiten zur Einrichtung LocalStack.

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

• Wählen Sie in der VS Code-Statusleiste das LocalStack Statussymbol aus, um die Aufforderung Setup LocalStack to Get Started zu öffnen, 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. Wenn Sie noch kein LocalStack Konto haben, führt Sie das System ebenfalls vor dem Authentifizierungsprozess durch die Kontoeinrichtung.

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 kann kostenlos verwendet werden und erfordert keine Registrierung. Sie läuft auf einem Docker-Image, 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 Verwendung mit der LocalStack Community Edition in VS Code erforderlich sind.

Eine neue Instanz starten

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

Anmerkung

Im folgenden Beispiel wird eine Container-Instance von LocalStack auf Port 4566 gestartet. Wenn Sie andere Portwerte angeben, müssen Sie den Portwert aktualisieren, der in dem Verfahren im Abschnitt Konfiguration von AWS CLI und AWS Toolkit angegeben wurde.

1. Öffnen Sie in VS Code das VS Code-Terminal, indem Sie aufctrl + `(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 gibt 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 Verwendung 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. 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 Verbindungsstatus-Menü.

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

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 zum Starten die LocalStack Schaltfläche Start LocalStack.

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

Ausgehend LocalStack von der 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 den Text in die Suchleiste ein und wählen Sie ihn aus der Liste aus, wenn er 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 aufctrl + `(backtick).

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

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

Eine serverlose Beispielanwendung erstellen

Um mit der Arbeit LocalStack in VS Code zu beginnen, benötigen Sie eine serverlose Beispielanwendung. Wenn Sie bereits über eine bestehende Anwendung in Ihrem AWS Konto verfügen, können Sie diese lokal mithilfe von 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 Haupt-Landingpage 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 AWS Cloud bereitgestellten Funktionen. 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 die Community Edition nicht verfügbar. LocalStack

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

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