Quick Start: Veröffentlichen von Anwendungen

So initialisieren Sie die Anwendung

1. Führen Sie den folgenden Befehl bei einer AWS SAM-CLI-Eingabeaufforderung aus.

   sam init --runtime python3.6 

2. Überprüfen Sie den Inhalt des Verzeichnisses, das der Befehl erstellt hat (sam-app/):

   • template.yaml— Definiert zweiAWS Ressourcen, die die Hello World-Anwendung benötigt: eine Lambda-Funktion und einen API-Gateway-Endpunkt, der eine GET-Operation unterstützt. Die Vorlage definiert auch die Zuweisung zwischen den beiden Ressourcen.

   • Inhalt im Zusammenhang mit dem Hello World-Anwendungscode:

     • hello_world/Verzeichnis — Enthält den Anwendungscode, der zurückgegeben wird,hello world wenn Sie ihn ausführen.

   Anmerkung

   Für diese Übung wird der Anwendungscode in Python geschrieben und Sie geben die Laufzeit im Befehl init an. AWS Lambda unterstützt zusätzliche Sprachen zum Erstellen von Anwendungscode. Wenn Sie eine andere unterstützte Laufzeit angeben, enthält der init-Befehl den Hello World-Code in der angegebenen Sprache und eine README.md-Datei, die Sie für diese Sprache befolgen können. Informationen zu unterstützten Laufzeiten finden Sie unter Lambda-Ausführungsumgebung und verfügbare Bibliotheken.

So testen Sie die Anwendung lokal

1. Starten Sie den API-Gateway-Endpunkt lokal. Sie müssen den folgenden Befehl aus dem Verzeichnis ausführen, das die template.yaml-Datei enthält.

   sam-app> sam local start-api --region us-east-1

   Der Befehl gibt einen API-Gateway-Endpunkt zurück, an den Sie Anfragen für lokale Tests senden können.

2. Testen Sie die Anwendung. Kopieren Sie die API Gateway Gateway-Endpunkt-URL, fügen Sie sie in den Browser ein und wählen Sie Enter. Ein Beispiel für eine API-Gateway-Endpunkt-URL lautethttp://127.0.0.1:3000/hello.

   API Gateway ruft lokal die Lambda-Funktion auf, der der Endpunkt zugeordnet ist. Die Lambda-Funktion wird im lokalen Docker-Container ausgeführt und kehrt zurückhello world. API Gateway gibt eine Antwort an den Browser zurück, die den Text enthält.

1. Bearbeiten Sie die /hello_world/app.py-Datei, um die Nachrichtenzeichenfolge von 'hello world' in 'Hello World!' zu ändern.

2. Laden Sie die Test-URL in Ihrem Browser neu und beachten Sie die neue Zeichenfolge.

So erstellen Sie ein Lambda-Bereitstellungspaket

1. Fügen Sie Ihrer AWS SAM-Vorlagendatei einen Metadata-Abschnitt hinzu, der die erforderlichen Anwendungsinformationen enthält. Weitere Informationen zum Abschnitt Metadata der AWS SAM-Vorlagen finden Sie unter AWS SAM Template Metadata Section Properties im AWS Serverless Application Model-Entwicklerhandbuch.

   Hier ist ein Metadata-Beispielabschnitt:

   Metadata:
     AWS::ServerlessRepo::Application:
       Name: my-app
       Description: hello world
       Author: user1
       SpdxLicenseId: Apache-2.0
       LicenseUrl: LICENSE.txt
       ReadmeUrl: README.md
       Labels: ['tests']
       HomePageUrl: https://github.com/user1/my-app-project
       SemanticVersion: 0.0.1
       SourceCodeUrl: https://github.com/user1/my-app-project

   DieReadmeUrl EigenschaftenLicenseUrl und können entweder Verweise auf lokale Dateien sein (wie im obigen Beispiel), oder sie können Links zu Amazon S3 S3-Buckets sein, die diese Artefakte bereits hosten.

2. Erstellen Sie einen S3-Bucket an dem Speicherort, an dem Sie den verpackten Code speichern möchten. Wenn Sie einen vorhandenen S3-Bucket verwenden möchten, überspringen Sie diesen Schritt.

   sam-app> aws s3 mb s3://bucketname

3. Erstellen Sie das Bereitstellungspaket für Lambda-Funktionen, indem Sie den folgendenpackageAWS SAM CLI-Befehl ausführen.

   sam-app> sam package \
       --template-file template.yaml \
       --output-template-file packaged.yaml \
       --s3-bucket bucketname

   Der Befehl hat folgende Auswirkungen:

   • Zippt den Inhalt desaws-sam/hello_world/ Verzeichnisses und lädt ihn auf Amazon S3 hoch.

   • Lädt das Bereitstellungspaket, die README-Datei und die LICENSE-Datei in den Amazon S3 S3-Bucket hoch, der durch die--s3-bucket Option angegeben wurde.

   • Gibt eine neue Vorlagendatei mit dem Namen packaged.yaml aus, die Sie im nächsten Schritt zum Veröffentlichen der Anwendung im AWS Serverless Application Repository verwenden. Diepackaged.yaml Vorlagendatei ähnelt der ursprünglichen Vorlagendatei (template.yaml), weist jedoch einen wesentlichen Unterschied auf: Die EigenschaftenCodeUriLicenseUrl, und dieReadmeUrl Eigenschaften verweisen auf den Amazon S3 S3-Bucket und die Objekte, die die entsprechenden Artefakte enthalten. Der folgende Ausschnitt aus einer packaged.yaml-Beispielvorlagendatei zeigt die CodeUri-Eigenschaft:

     HelloWorldFunction:
         Type: AWS::Serverless::Function # For more information about function resources, see https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
         Properties:
           CodeUri: s3://bucketname/fbd77a3647a4f47a352fcObjectGUID
     
     ...

So veröffentlichen Sie die serverlose Anwendung auf dem AWS Serverless Application Repository

• Führen Sie den folgenden Befehl aus, um die neue Anwendung mit der ersten Version in AWS Serverless Application Repository zu veröffentlichen, die als 0.0.1 erstellt wurde.

  sam-app> sam publish \
      --template packaged.yaml \
      --region us-east-1