Arbeiten AWS SAM mit dem AWS Toolkit

1. Öffnen Sie im AWS Explorer das Kontextmenü (Rechtsklick) für den Lambda-Knoten und wählen Sie dann SAMLambda-Anwendung erstellen.

   Anmerkung

   Alternativ können Sie das Menüsymbol gegenüber der Überschrift AWS: Explorer auswählen und SAMLambda-Anwendung erstellen auswählen.

2. Wählen Sie die Laufzeit für Ihre SAM Anwendung aus. Wählen Sie in diesem Beispiel nodejs12.x.

   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.

3. Wählen Sie eine der folgenden Vorlagen für Ihre Serverless-App aus:

   • AWS SAM Hello World: Eine einfache Vorlage mit einer Lambda-Funktion, die die klassische „Hello World“ -Meldung zurückgibt.

   • AWS Step Functions Beispiel-App: Eine Beispielanwendung, die einen Aktienhandels-Workflow ausführt. Schrittfunktionen orchestrieren die Interaktionen der beteiligten Lambda Funktionen.

4. Wählen Sie einen Speicherort für Ihr neues Projekt aus. Wenn verfügbar, können Sie einen vorhandenen Workspace-Ordner auswählen. Andernfalls suchen Sie nach einem anderen Ordner. Wenn Sie auf Select a different folder (Einen anderen Ordner auswählen) klicken, wird ein Dialogfeld angezeigt, in dem Sie einen Ordnerspeicherort festlegen können.

5. Geben Sie einen Namen für Ihre Anwendung ein. Wählen Sie für dieses Beispiel my-sam-app-nodejs. Nachdem Sie die Eingabetaste gedrückt haben, benötigt das AWS Toolkit einen Moment, um das Projekt zu erstellen.

Um eine SAM Vorlage zum Ausführen und Debuggen einer serverlosen Anwendung zu verwenden

1. Um Ihre Anwendungsdateien anzuzeigen, aus denen Ihre serverless Anwendung besteht, rufen Sie das Fenster Environment (Umgebung) auf.

2. Öffnen Sie die template.yaml Datei im Anwendungsordner (z. B. my-sample-app).

3. Wählen Sie für template.yaml die Option Edit Launch Configuration (Startkonfiguration bearbeiten) aus.

   Ein neuer Editor zeigt die launch.json-Datei, die eine Debugging-Konfiguration mit Standardattributen bereitstellt.

4. Bearbeiten oder bestätigen Sie Werte für die folgenden Konfigurationseigenschaften:

   • "name" – Geben Sie einen leserfreundlichen Namen ein, der in der im Dropdown-Feld Configuration (Konfiguration) der Ansicht Run (Ausführen) angezeigt wird.

   • "target" – Vergewissern Sie sich, dass der Wert "template" ist. Auf diese Weise ist die SAM Vorlage 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 im Abschnitt Ressourcen der SAM Vorlage angegeben ist. 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.

5. Wenn Sie mit Ihrer Debug-Konfiguration zufrieden sind, speichern Sie launch.json. Wählen Sie dann die grüne Schaltfläche „Abspielen“ neben, um mit dem Debuggen RUNzu beginnen.

   Anmerkung

   Wenn Ihre SAM Anwendung nicht ausgeführt werden kann, überprüfen Sie im Ausgabefenster, ob der Fehler durch ein Docker-Image verursacht wird, das nicht erstellt wird. Sie müssen möglicherweise Speicherplatz in Ihrer Umgebung freigeben.

   Weitere Informationen finden Sie unter Fehler beim lokalen Ausführen von SAM Anwendungen im AWS Toolkit, da die AWS Cloud9 Umgebung nicht über genügend Festplattenspeicher verfügt.

   Wenn die Debugging-Sitzungen gestartet werden, zeigt das DEBUGCONSOLEPanel die Debugging-Ausgabe und alle Werte an, die von der Lambda-Funktion zurückgegeben werden. Beim Debuggen von SAM Anwendungen wird das AWS Toolkit im Bedienfeld „Ausgabe“ als Ausgabekanal ausgewählt.

   Anmerkung

   Wenn bei diesem Vorgang ein Docker-Mounting-Fehler auftritt, müssen Windows-Benutzer die Anmeldeinformationen für ihre freigegebenen Laufwerke in Docker Settings (Docker-Einstellungen) möglicherweise aktualisieren. Ein Docker-Mounting-Fehler sieht etwa folgendermaßen aus.

   Fetching lambci/lambda:nodejs10.x Docker container image......
   2019-07-12 13:36:58 Mounting C:\Users\<username>\AppData\Local\Temp\ ... as /var/task:ro,delegated inside runtime container
   Traceback (most recent call last):
   ...requests.exceptions.HTTPError: 500 Server Error: Internal Server Error ...

So führen und debuggen Sie eine serverless Anwendung direkt aus dem Anwendungscode

1. Wenn Sie Serverless-Anwendungsdateien anzeigen möchten, navigieren Sie zum Anwendungsordner, indem Sie das Ordnersymbol neben dem Editor auswählen.

2. Erweitern Sie im Anwendungsordner (z. B. my-sample-app) den Funktionsordner (in diesem Beispiel hello-world) und öffnen Sie die Datei. app.js

3. Wählen Sie in der Inline-Aktion, die eine berechtigte Lambda Handler-Funktion identifiziert, Add Debug Configuration aus. Wenn die Option zum Hinzufügen einer Debug-Konfiguration nicht angezeigt wird, müssen Sie CodeLenses aktivieren. Informationen zum Aktivieren von Code Lenses finden Sie unter AWS Toolkit-Codelinsen aktivieren .

   

4. Wählen Sie die Laufzeit aus, in der Ihre SAM Anwendung ausgeführt wird.

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.

   • "target"— Stellen Sie sicher, dass der Wert "code" ist, sodass ein Lambda Funktionshandler direkt aufgerufen wird.

   • "lambdaHandler" – Geben Sie den Namen der Methode innerhalb Ihres Codes ein, die die Lambda-Funktion zum Ausführen Ihrer Funktion aufruft. Für Anwendungen in JavaScript ist die Standardeinstellung beispielsweiseapp.lambdaHandler.

   • "projectRoot"— Geben Sie den Pfad zur Anwendungsdatei ein, die die Lambda -Funktion enthält.

   • "runtime" – Geben Sie eine gültige Laufzeit für die Lambda-Ausführungsumgebung ein oder bestätigen Sie diese (z. B. "nodejs.12x").

   • "payload"— Wählen Sie eine der folgenden Optionen zum Definieren der Ereignis-Nutzlast aus, die Sie Ihrer Lambda -Funktion als Eingabe bereitstellen möchten:

     • "json": JSON -formatierte Schlüssel-Wert-Paare, die die Nutzlast des Ereignisses definieren.

     • "path": Ein Pfad zu der Datei, die als Ereignisnutzlast verwendet wird.

6. Wenn Sie mit der Debug-Konfiguration zufrieden sind, klicken Sie auf den grünen Wiedergabepfeil neben, um mit dem Debuggen zu beginnen. RUN

   Wenn die Debugging-Sitzungen gestartet werden, zeigt das DEBUGCONSOLEPanel die Debugging-Ausgabe und alle Werte an, die von der Lambda-Funktion zurückgegeben werden. Beim Debuggen von SAM Anwendungen wird AWS Toolkit im Bedienfeld „Ausgabe“ als Ausgabekanal ausgewählt.

   Anmerkung

   Wenn Docker in Fehlermeldungen erwähnt wird, lesen Sie diesen Hinweis.

Um lokale API Gateway-Ressourcen auszuführen und zu debuggen

1. Wählen Sie einen der folgenden Ansätze, um eine Startkonfiguration für eine AWS SAM API Gateway-Ressource zu erstellen:

   • Option 1: Rufen Sie den Handler-Quellcode (insbesondere die .js-, .cs- oder .py-Datei) in Ihrem AWS SAM -Projekt auf. Bewegen Sie den Mauszeiger über den Lambda-Handler und wählen Sie Add Debug Configuration (Debug-Konfiguration hinzufügen) aus. Wenn die Option zum Hinzufügen einer Debug-Konfiguration nicht angezeigt wird, müssen Sie CodeLenses aktivieren. Informationen zum Aktivieren von CodeLenses finden Sie unter AWS Toolkit-Codelinsen aktivieren .) Wählen Sie dann im Menü den Eintrag mit der Bezeichnung API Event aus.

   • Option 2 Bearbeiten launch.json und erstellen Sie eine neue Startkonfiguration mithilfe der folgenden Syntax.

     {
         "type": "aws-sam",
         "request": "direct-invoke",
         "name": "myConfig",
         "invokeTarget": {
             "target": "api",
             "templatePath": "n12/template.yaml",
             "logicalId": "HelloWorldFunction"
         },
         "api": {
             "path": "/hello",
             "httpMethod": "post",
             "payload": {
                 "json": {}
             }
         }, 
         "sam": {},
         "aws": {}
     }
                             

2. Wählen Sie im Dropdown-Menü neben Run (Ausführen) die Startkonfiguration (mit dem Namen myConfig im vorherigen Beispiel) aus.

3. (Optional) Fügen Sie Ihrem Lambda Projektcode Haltepunkte hinzu.

4. Wählen Sie das Symbol Run (Ausführen) neben der grünen Schaltfläche „Wiedergeben“ aus.

5. Zeigen Sie im Ausgabefenster die Ergebnisse an.

1. Öffnen Sie im AWS Explorer-Fenster das Kontextmenü (Rechtsklick) für den Lambda-Knoten und wählen Sie SAMAnwendung synchronisieren aus.

2. Wählen Sie die aus AWS-Region , für die Bereitstellung verwendet werden soll.

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

4. Geben Sie den Namen eines Amazon-S3-Buckets ein, den diese Bereitstellung verwenden kann. Der Bucket muss sich in der Region befinden, in der die Bereitstellung erfolgt.

   Warnung

   Der Amazon-S3-Bucket-Name muss unter den in Amazon S3 vorhandenen Bucket-Namen global eindeutig sein. Fügen Sie dem im folgenden Beispiel angegebenen Namen einen eindeutigen Bezeichner hinzu oder wählen Sie einen anderen Namen aus.

5. Wenn Ihre serverlose Anwendung eine Funktion mit Pakettyp enthältImage, geben Sie den Namen eines ECR Amazon-Repositorys ein, das diese Bereitstellung verwenden kann. Der Bucket muss sich in der Region befinden, in der Sie bereitstellen.

6. Geben Sie einen Namen für den bereitgestellten Stack ein, entweder einen neuen Stacknamen oder einen vorhandenen Stacknamen.

7. Überprüfen Sie den Erfolg der Bereitstellung auf der Registerkarte AWS Toolkit von der Konsole.

   Wenn ein Fehler auftritt, wird rechts unten eine Meldung angezeigt.

   Wenn dies der Fall ist, überprüfen Sie den Text auf der Registerkarte AWS Toolkit, um Details zu erhalten. Im Folgenden finden Sie ein Beispiel für Fehlerdetails.

   Error with child process: Unable to upload artifact HelloWorldFunction referenced by CodeUri parameter of HelloWorldFunction resource.
   S3 Bucket does not exist. Execute the command to create a new bucket
   aws s3 mb s3://pbart-my-sam-app-bucket
   An error occurred while deploying a SAM Application. Check the logs for more information by running the "View AWS Toolkit Logs" command from the Command Palette.

   In diesem Beispiel ist der Fehler aufgetreten, weil der Amazon-S3-Bucket nicht vorhanden war.