Erste Schritte mit serverlosen Anwendungen

In den folgenden Abschnitten wird beschrieben, wie Sie mit der Erstellung eines beginnenAWS-Serverless-Anwendungvon derAWS Toolkit for Visual Studio Code, unter VerwendungAWS Serverless Application Model(AWS SAM) undAWS CloudFormationStapel.

Voraussetzungen

Bevor Sie ein erstellen oder damit arbeiten könnenAWS-Serverless-Anwendung, müssen die folgenden Voraussetzungen erfüllt sein.

Anmerkung

Bei den folgenden Vorgängen müssen Sie VS Code möglicherweise beenden oder neu starten, bevor die Änderungen abgeschlossen sind.

• Installieren Sie dasAWS SAMBefehlszeilenschnittstelle (CLI). Für zusätzliche Informationen und Anweisungen zur Installation desAWS SAMCLI finden Sie imInstallation desAWS SAMCLIThema in diesemAWS Serverless Application ModelBenutzerleitfaden.

• Von deinemAWSKonfigurationsdatei, identifizieren Sie Ihre StandardeinstellungAWSRegion. Weitere Informationen zu Ihrer Konfigurationsdatei finden Sie in derEinstellungen für die Konfiguration und die AnmeldeinformationsdateiThema imAWS Command Line InterfaceBenutzerleitfaden.

• Installieren Sie Ihr Sprach-SDK und konfigurieren Sie Ihre Toolchain. Weitere Informationen zur Konfiguration Ihrer Toolchain finden Sie unterAWS Toolkit for Visual Studio Codesiehe diekonfiguriere deine ToolchainThema in diesem Benutzerhandbuch.

• Installieren Sie dasErweiterung zur Unterstützung der YAML-Sprachevom VS Code-Marktplatz. Dies ist erforderlich fürCodeLensMerkmal vonAWS SAMauf Vorlagendateien kann zugegriffen werden. Für weitere Informationen überCodeLens, sieheCodeLensAbschnitt in der VS Code-Dokumentation

IAM-Berechtigungen für serverlose Anwendungen

Im Toolkit für VS Code benötigen Sie ein Anmeldeinformationsprofil, das Folgendes enthältAWS Identity and Access Management(IAM) -Berechtigungen, die für die Bereitstellung und Ausführung serverloser Anwendungen erforderlich sind. Sie benötigen den entsprechenden Lese-/Schreibzugriff auf die folgenden Dienste:AWS CloudFormation, IAM, Lambda, Amazon API Gateway, Amazon Simple Storage Service (Amazon S3) und Amazon Elastic Container Registry (Amazon ECR).

Weitere Informationen zur Einrichtung der Authentifizierung, die für die Bereitstellung und Ausführung serverloser Anwendungen erforderlich ist, finden Sie inVerwaltung des Ressourcenzugriffs und der Berechtigungenin derAWS Serverless Application ModelLeitfaden für Entwickler. Informationen zur Einrichtung Ihrer Anmeldedaten finden Sie imAWSIAM-Anmeldeinformationenin diesem Benutzerhandbuch.

Eine neue serverlose Anwendung (lokal) erstellen

Dieses Verfahren zeigt, wie Sie eine serverlose Anwendung mit dem Toolkit für VS Code erstellen, indem SieAWS SAM. Die Ausgabe dieses Verfahrens ist ein lokales Verzeichnis auf Ihrem Entwicklungshost, das eine serverlose Beispielanwendung enthält, die Sie erstellen, lokal testen, ändern und auf demAWSCloud.

1. Um das zu öffnenBefehlspalette, wählenAnsehen,Befehlspalette, und geben Sie dann einAWS.

2. WähleAWSToolkit Lambda-SAM-Anwendung erstellen.

   

   Anmerkung

   Wenn derAWS SAMCLI ist nicht installiert, in der unteren rechten Ecke des VS Code-Editors wird eine Fehlermeldung angezeigt. Stellen Sie in diesem Fall sicher, dass Sie alle Anforderungen erfüllt habenAnnahmen und Voraussetzungen.

3. Wählen Sie die Laufzeit für IhreAWS SAMAnwendung.

   Anmerkung

   Wenn Sie eine der Laufzeiten mit „(Image)“ auswählen, ist Ihre Anwendung Pakettyp Image. Wenn Sie eine der Laufzeiten ohne „(Image)“ auswählen, ist Ihre Anwendung der Typ Zip. Für weitere Informationen zu den Unterschieden zwischen Image und Zip Pakettypen finden Sie unter Lambda-Bereitstellungspakete im AWS Lambda Entwicklerhandbuch.

4. Abhängig von der ausgewählten Laufzeit werden Sie möglicherweise aufgefordert, einen Abhängigkeitsmanager und eine Laufzeitarchitektur für Ihre SAM-Anwendung auszuwählen.

   Dependency Manager

   Wählen Sie zwischenGradleoderMaven.

   Anmerkung

   Diese Auswahl an Tools zur Build-Automatisierung ist nur für Java-Laufzeiten verfügbar.

   Architecture

   Wählen Sie zwischenx86_64oderarm64.

   Die Option, Ihre serverlose Anwendung in einer ARM64-basierten emulierten Umgebung anstelle der standardmäßigen x86_64-basierten Umgebung auszuführen, ist für die folgenden Laufzeiten verfügbar:

   • nodejs12.x (ZIP und Bild)

   • nodejs14.x (ZIP und Bild)

   • python3.8 (ZIP und Bild)

   • python3.9 (ZIP und Bild)

   • python3.10 (ZIP und Bild)

   • python3.11 (ZIP und Bild)

   • java8.al2 mit Gradle (ZIP und Bild)

   • java8.al2 mit Maven (nur ZIP)

   • java11 mit Gradle (ZIP und Bild)

   • java11 mit Maven (nur ZIP)

   Wichtig

   Sie müssen installierenAWS CLIVersion 1.33.0 oder höher, damit Anwendungen in ARM64-basierten Umgebungen ausgeführt werden können. Weitere Informationen finden Sie unter Voraussetzungen.

5. Wählen Sie einen Speicherort für Ihr neues Projekt aus. Sie können einen vorhandenen Arbeitsbereichordner verwenden, wenn einer geöffnet ist, mit Select a different folder (Einen anderen Ordner wählen) einen bereits vorhandenen Ordner auswählen oder einen neuen Ordner erstellen und auswählen. Wählen Sie in diesem Beispiel die Option There are no workspace folders open (Es sind keine Arbeitsbereichsordner geöffnet), um einen Ordner mit dem Namen MY-SAM-APP zu erstellen.

6. Geben Sie einen Namen für Ihr neues Projekt ein. Wählen Sie für dieses Beispiel my-sam-app-nodejs. Nachdem du gedrückt hastGeben Sie ein, das Toolkit für VS Code benötigt einen Moment, um das Projekt zu erstellen.

Wenn das Projekt erstellt wird, wird Ihre Anwendung Ihrem aktuellen Arbeitsbereich hinzugefügt. Sie sollten es im Explorer-Fenster sehen.

Öffnen einer serverlosen Anwendung (lokal)

Um eine serverlose Anwendung auf Ihrem lokalen Entwicklungshost zu öffnen, öffnen Sie den Ordner, der die Vorlagendatei der Anwendung enthält.

1. Aus demDatei, wählenOrdner öffnen....

2. In derOrdner öffnenNavigieren Sie im Dialogfeld zu dem serverlosen Anwendungsordner, den Sie öffnen möchten.

3. Wählen Sie dieWählen Sie OrdnerSchaltfläche.

Wenn Sie den Ordner einer Anwendung öffnen, wird er dem Ordner hinzugefügtExplorerFenster.

Eine serverlose Anwendung anhand einer Vorlage ausführen und debuggen (lokal)

Sie können das Toolkit für VS Code verwenden, um zu konfigurieren, wie serverlose Anwendungen debuggt und lokal in Ihrer Entwicklungsumgebung ausgeführt werden.

Sie beginnen mit der Konfiguration des Debug-Verhaltens mithilfe des VS-CodesCodeLensFunktion zur Identifizierung einer geeigneten Lambda-Funktion. CodeLensermöglicht inhaltsorientierte Interaktionen mit Ihrem Quellcode. Für Informationen darüber, wie Sie sicherstellen können, dass Sie auf die zugreifen könnenCodeLensDiese Funktion finden Sie unterVoraussetzungenAbschnitt von früher in diesem Thema.

Anmerkung

In diesem Beispiel debuggen Sie eine Anwendung, dieJavaScript. Sie können jedoch die Debugging-Funktionen von Toolkit for VS Code mit den folgenden Sprachen und Laufzeiten verwenden:

• C# — .NET Core 2.1, 3.1; .NET 5.0

• JavaScript/TypeScript— Node.js 12.x, 14.x

• Python — 3.6, 3.7, 3.8, 3.9, 3.10, 3.11

• Java — 8, 8.al2, 11

• Gehe — 1.x

Ihre Sprachauswahl wirkt sich auch darauf aus, wieCodeLenserkennt geeignete Lambda-Handler. Weitere Informationen finden Sie unter Lambda-Funktionen direkt aus dem Code ausführen und debuggen.

In diesem Verfahren verwenden Sie die Beispielanwendung, die in derEine neue serverlose Anwendung (lokal) erstellenAbschnitt weiter oben in diesem Thema.

1. Um Ihre Anwendungsdateien im Datei-Explorer von VS Code anzuzeigen, wählen SieAnsehen,Entdecker.

2. Aus dem Anwendungsordner (zum Beispielmy-sample-app), öffnen Sietemplate.yamldatei.

   Anmerkung

   Wenn Sie eine Vorlage mit einem anderen Namen verwenden alstemplate.yaml, derCodeLensDer Indikator ist nicht automatisch in der YAML-Datei verfügbar. Das bedeutet, dass Sie manuell eine Debug-Konfiguration hinzufügen müssen.

3. Im Editor fürtemplate.yaml, gehe zumResourcesAbschnitt der Vorlage, der serverlose Ressourcen definiert. In diesem Fall ist dasHelloWorldFunctionRessource des TypsAWS::Serverless::Function.

   In derCodeLensIndikator für diese Ressource wählenDebug-Konfiguration hinzufügen.

   

4. In derBefehlspalette, wählen Sie die Laufzeit aus, in der IhrAWS SAMAnwendung wird ausgeführt.

5. Klicken Sie im Editor für die Datei launch.json, bearbeiten oder bestätigen Sie Werte für die folgenden Konfigurationseigenschaften:

   • "name"— Geben Sie einen leserfreundlichen Namen ein, der in der Konfiguration im Dropdownfeld Ausführen angezeigt wird.

   • "target"— Stellen Sie sicher, dass der Wert"template"so dass derAWS SAMDie Vorlage ist der Einstiegspunkt für die Debug-Sitzung.

   • "templatePath"— Geben Sie einen relativen oder absoluten Pfad für die Datei template.yaml an.

   • "logicalId"— Stellen Sie sicher, dass der Name mit dem Namen übereinstimmt, der in derRessourcenAbschnitt derAWS SAMVorlage. In diesem Fall handelt es sich um den HelloWorldFunction vom Typ AWS::Serverless::Function.

   

   Weitere Informationen zu diesen und anderen Einträgen in launch.json finden Sie in Konfigurationsoptionen für das Debuggen von serverless Anwendungen.

6. Wenn Sie mit Ihrer Debug-Konfiguration zufrieden sind, speichern Sie launch.json. Um dann mit dem Debuggen zu beginnen, wählen Sie die grüne Schaltfläche „Abspielen“ in derLAUFansehen.

   Wenn die Debugging-Sitzungen gestartet werden, wird die DEBUGKONSOLE zeigt die Debugging-Ausgabe an und zeigt alle von der Lambda Funktion zurückgegebenen Werte an. (Beim DebuggenAWS SAMAnwendungen, dieAWSToolkitist ausgewählt alsAusgabeKanal imAusgangPanel.)

SynchronisierenAWS SAMAnwendungen

DieAWS Toolkit for Visual Studio Codeläuft dieAWS SAMCLI-Befehlsam syncum Ihre serverlosen Anwendungen auf dem bereitzustellenAWS Cloud. Für weitere Informationen überAWS SAMSync finden Sie imAWS SAMCLI-BefehlsreferenzThema in derAWS Serverless Application ModelLeitfaden für Entwickler

Das folgende Verfahren beschreibt, wie Sie Ihre serverlosen Anwendungen auf demAWS Cloudmitsam syncaus dem Toolkit für VS Code.

1. Öffnen Sie im Hauptmenü von VS Code denBefehlspalettedurch ErweiternAnsichtund wählenBefehlspalette.

2. Aus demBefehlspalettesuche nachAWSund wähleSAM-Anwendung synchronisierenum mit der Einrichtung Ihrer Synchronisation zu beginnen.

   

3. Wählen Sie dieAWSRegion, mit der Ihre serverlose Anwendung synchronisiert werden soll.

4. Wählen Sie die template.yaml-Datei aus, die für die Bereitstellung verwendet werden soll.

5. Wählen Sie einen vorhandenen Amazon S3-Bucket aus oder geben Sie einen neuen Amazon S3-Bucket-Namen ein, in dem Sie Ihre Anwendung bereitstellen möchten.

   Wichtig

   Ihr Amazon S3-Bucket muss die folgenden Anforderungen erfüllen:

   • Der Bucket muss sich in der Region befinden, mit der Sie synchronisieren.

   • Der Amazon-S3-Bucket-Name muss unter den in Amazon S3 vorhandenen Bucket-Namen global eindeutig sein.

6. Wenn Ihre serverless Anwendung eine Funktion mit dem Pakettyp Image. Geben Sie den Namen eines Amazon ECR-Repositorys ein, das diese Bereitstellung verwenden kann. Der Bucket muss sich in der Region befinden, in der Sie bereitstellen.

7. Wählen Sie einen Deployment-Stack aus der Liste Ihrer vorherigen Deployments aus oder erstellen Sie einen neuen Deployment-Stack, indem Sie einen neuen Stack-Namen eingeben. Fahren Sie dann fort, um den Synchronisierungsvorgang zu starten.

   Anmerkung

   Stacks, die in früheren Bereitstellungen verwendet wurden, werden pro Workspace und Region zurückgerufen.

8. Während des Synchronisierungsvorgangs wird der Status Ihrer Bereitstellung imTerminalRegisterkarte von VS Code. Stellen Sie auf der Registerkarte Terminal sicher, dass Ihre Synchronisierung erfolgreich war. Wenn ein Fehler auftritt, erhalten Sie eine Benachrichtigung.

   

   Anmerkung

   Weitere Informationen zu Ihrer Synchronisierung finden Sie unterAWS Toolkit for Visual Studio CodeAuf die Protokolle kann über die zugegriffen werdenBefehlspalette.

   Um auf Ihre zuzugreifenAWS Toolkit for Visual Studio CodeLogs aus der Befehlspalette erweiternAnsicht, wählenBefehlspalette, suchen Sie dann nachAWS: View AWS Toolkits Logs, und wählen Sie es aus, wenn es in der Liste angezeigt wird.

Wenn die Bereitstellung abgeschlossen ist, wird Ihre Anwendung in derAWSExplorer. Weitere Informationen zum Aufrufen der Lambda-Funktion, die als Teil der Anwendung erstellt wurde, finden Sie inInteraktion mit Remote-Lambda-FunktionenThema in diesem Benutzerhandbuch.

Löschen einer serverlosen Anwendung aus demAWS Cloud

Beim Löschen einer serverless Anwendung wird der AWS CloudFormation-Stack gelöscjt, den Sie zuvor für die AWS Cloud bereitgestellt haben. Beachten Sie, dass dieses Verfahren Ihr Anwendungsverzeichnis nicht von Ihrem lokalen Host löscht.

1. Öffnen Sie die AWS-Explorer.

2. In derAWSToolkit-ExplorerErweitern Sie in diesem Fenster die Region, die die bereitgestellte Anwendung enthält, die Sie löschen möchten, und erweitern Sie dannAWS CloudFormation.

3. Öffnen Sie das Kontextmenü (Rechtsklick) für den Namen desAWS CloudFormationStapel, der der serverlosen Anwendung entspricht, die Sie löschen möchten, und wählen Sie dannLöschenAWS CloudFormationStapel.

4. Um zu bestätigen, dass Sie den ausgewählten Stapel löschen möchten, wählen SieJa.

Wenn das Löschen des Stacks erfolgreich ist, entfernt das Toolkit for VS Code den Stack-Namen aus demAWS CloudFormationliste inAWSEntdecker.