Tutorial: Bereitstellen einer Hello World-Anwendung - AWS Serverless Application Model

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Tutorial: Bereitstellen einer Hello World-Anwendung

In diesem Tutorial verwenden Sie die AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAMCLI), um Folgendes auszuführen:

  • Initialisieren, erstellen und implementieren Sie eine Hello World-Beispielanwendung.

  • Nehmen Sie lokale Änderungen vor und synchronisieren Sie sie mitAWS CloudFormation.

  • Testen Sie Ihre Anwendung in derAWS Cloud.

  • Führen Sie optional lokale Tests auf Ihrem Entwicklungshost durch.

  • Löschen Sie die Beispielanwendung aus demAWS Cloud.

Die Beispielanwendung Hello World implementiert ein grundlegendes API-Backend. Es besteht aus den folgenden Ressourcen:

  • Amazon API Gateway — API-Endpunkt, den Sie verwenden, um Ihre Funktion aufzurufen.

  • AWS Lambda— Funktion, die die HTTP-API-GET-Anfrage verarbeitet und eine hello world Nachricht zurückgibt.

  • AWS Identity and Access Management(IAM) -Rolle — Stellt Berechtigungen für die sichere Interaktion der Dienste bereit.

Das folgende Diagramm zeigt die Komponenten dieser Anwendung:


			Ein Diagramm einer Lambda-Funktion, die aufgerufen wird, wenn Sie eine GET-Anfrage an den API Gateway-Endpunkt senden.

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Schritte ausgeführt haben:

Schritt 1: Initialisieren Sie die Hello World-Beispielanwendung

In diesem Schritt verwenden Sie die AWS SAM CLI, um ein Beispiel für ein Hello World-Anwendungsprojekt auf Ihrem lokalen Computer zu erstellen.

Um die Hello World-Beispielanwendung zu initialisieren
  1. Führen Sie in Ihrer Befehlszeile Folgendes aus einem Startverzeichnis Ihrer Wahl aus:

    $ sam init
  2. Die AWS SAM CLI führt Sie durch die Initialisierung einer neuen Anwendung. Konfigurieren Sie Folgendes:

    1. Wählen Sie AWSSchnellstartvorlagen aus, um eine Startvorlage auszuwählen.

    2. Wählen Sie die Hello World-Beispielvorlage und laden Sie sie herunter.

    3. Verwenden Sie die Python Laufzeit und den zip Pakettyp.

    4. Deaktiviere für dieses Tutorial die AWS X-Ray Protokollierung. Weitere Informationen finden Sie unter Was istAWS X-Ray? im AWS X-RayEntwicklerleitfaden.

    5. Für dieses Tutorial deaktivieren Sie die Überwachung mit Amazon CloudWatch Application Insights. Weitere Informationen finden Sie unter Amazon CloudWatch Application Insights im CloudWatchAmazon-Benutzerhandbuch.

    6. Benennen Sie Ihre Anwendung als sam-App.

    Um den interaktiven AWS SAM CLI-Flow zu verwenden:

    • Klammern ([ ]) geben Standardwerte an. Lassen Sie Ihre Antwort leer, um den Standardwert auszuwählen.

    • Geben Sie y für Ja und n für Nein ein.

    Das Folgende ist ein Beispiel für den sam init interaktiven Ablauf:

    $ sam init ... Which template source would you like to use? 1 - AWS Quick Start Templates 2 - Custom Template Location Choice: 1 Choose an AWS Quick Start application template 1 - Hello World Example 2 - Multi-step workflow 3 - Serverless API 4 - Scheduled task 5 - Standalone function 6 - Data processing 7 - Hello World Example With Powertools 8 - Infrastructure event management 9 - Serverless Connector Hello World Example 10 - Multi-step workflow with Connectors 11 - Lambda EFS example 12 - DynamoDB Example 13 - Machine Learning Template: 1 Use the most popular runtime and package type? (Python and zip) [y/N]: y Would you like to enable X-Ray tracing on the function(s) in your application? [y/N]: Would you like to enable monitoring using CloudWatch Application Insights? For more info, please view https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html [y/N]: Project name [sam-app]:
  3. Die AWS SAM CLI lädt Ihre Startvorlage herunter und erstellt die Verzeichnisstruktur des Anwendungsprojekts auf Ihrem lokalen Computer. Das Folgende ist ein Beispiel für die AWS SAM CLI-Ausgabe:

    Cloning from https://github.com/aws/aws-sam-cli-app-templates (process may take a moment)
    
        -----------------------
        Generating application:
        -----------------------
        Name: sam-app
        Runtime: python3.9
        Architectures: x86_64
        Dependency Manager: pip
        Application Template: hello-world
        Output Directory: .
        Configuration file: sam-app/samconfig.toml
    
        Next steps can be found in the README file at sam-app/README.md
    
    
    Commands you can use next
    =========================
    [*] Create pipeline: cd sam-app && sam pipeline init --bootstrap
    [*] Validate SAM template: cd sam-app && sam validate
    [*] Test Function in the Cloud: cd sam-app && sam sync --stack-name {stack-name} --watch
  4. Wechseln Sie von der Befehlszeile aus in das neu erstellte sam-app Verzeichnis. Das Folgende ist ein Beispiel dafür, was die AWS SAM CLI erstellt hat:

    $ cd sam-app $ tree ├── README.md ├── __init__.py ├── events │ └── event.json ├── hello_world │ ├── __init__.py │ ├── app.py │ └── requirements.txt ├── samconfig.toml ├── template.yaml └── tests ├── __init__.py ├── integration │ ├── __init__.py │ └── test_api_gateway.py ├── requirements.txt └── unit ├── __init__.py └── test_handler.py 6 directories, 14 files

    Einige wichtige Dateien, die Sie hervorheben sollten:

    • hello_world/app.py— Enthält Ihren Lambda-Funktionscode.

    • hello_world/requirements.txt— Enthält alle Python Abhängigkeiten, die Ihre Lambda-Funktion benötigt.

    • samconfig.toml— Konfigurationsdatei für Ihre Anwendung, in der die von der AWS SAM CLI verwendeten Standardparameter gespeichert werden.

    • template.yaml— Die AWS SAM Vorlage, die Ihren Anwendungsinfrastrukturcode enthält.

Sie haben jetzt eine vollständig erstellte serverlose Anwendung auf Ihrem lokalen Computer!

Schritt 2: Erstellen Sie Ihre Anwendung

In diesem Schritt verwenden Sie die AWS SAM CLI, um Ihre Anwendung zu erstellen und die Bereitstellung vorzubereiten. Beim Erstellen erstellt die AWS SAM CLI ein .aws-sam Verzeichnis und organisiert dort Ihre Funktionsabhängigkeiten, Projektcode und Projektdateien.

Um Ihre Anwendung zu erstellen
  • Führen Sie in Ihrer Befehlszeile aus dem sam-app Projektverzeichnis Folgendes aus:

    $ sam build
    Anmerkung

    Wenn Sie dies nicht Python auf Ihrem lokalen Computer haben, verwenden Sie stattdessen den sam build --use-container Befehl. Die AWS SAM CLI erstellt einen Docker Container, der die Laufzeit und die Abhängigkeiten Ihrer Funktion enthält. Dieser Befehl erfordert Docker auf Ihrem lokalen Computer. Informationen zur Installation Docker finden Sie unterInstallieren von Docker.

    Das Folgende ist ein Beispiel für die AWS SAM CLI-Ausgabe:

    $ sam build Starting Build use cache Manifest file is changed (new hash: 3298f1304...d4d421) or dependency folder (.aws-sam/deps/4d3dfad6-a267-47a6-a6cd-e07d6fae318c) is missing for (HelloWorldFunction), downloading dependencies and copying/building source Building codeuri: /Users/.../Demo/sam-tutorial1/sam-app/hello_world runtime: python3.9 metadata: {} architecture: x86_64 functions: HelloWorldFunction Running PythonPipBuilder:CleanUp Running PythonPipBuilder:ResolveDependencies Running PythonPipBuilder:CopySource Running PythonPipBuilder:CopySource Build Succeeded Built Artifacts : .aws-sam/build Built Template : .aws-sam/build/template.yaml Commands you can use next ========================= [*] Validate SAM template: sam validate [*] Invoke Function: sam local invoke [*] Test Function in the Cloud: sam sync --stack-name {{stack-name}} --watch [*] Deploy: sam deploy --guided

    Das Folgende ist ein verkürztes Beispiel für das von der AWS SAM CLI erstellte .aws-sam Verzeichnis:

    .aws-sam
    ├── build
    │   ├── HelloWorldFunction
    │   │   ├── __init__.py
    │   │   ├── app.py
    │   │   └── requirements.txt
    │   └── template.yaml
    └── build.toml

Einige wichtige Dateien, die Sie hervorheben sollten:

  • build/HelloWorldFunction— Enthält Ihren Lambda-Funktionscode und Abhängigkeiten. Die AWS SAM CLI erstellt ein Verzeichnis für jede Funktion in Ihrer Anwendung.

  • build/template.yaml— Enthält eine Kopie Ihrer AWS SAM Vorlage, auf die AWS CloudFormation bei der Bereitstellung verwiesen wird.

  • build.toml— Konfigurationsdatei, die Standardparameterwerte speichert, auf die von der AWS SAM CLI beim Erstellen und Bereitstellen Ihrer Anwendung verwiesen wird.

Sie sind jetzt bereit, Ihre Anwendung auf dem bereitzustellenAWS Cloud.

Schritt 3: Stellen Sie Ihre Anwendung auf dem bereit AWS Cloud

Anmerkung

Dieser Schritt erfordert die Konfiguration der AWS Anmeldeinformationen. Weitere Informationen finden Sie unter Schritt 5: Verwenden Sie die, AWS CLI um die AWS Anmeldeinformationen zu konfigurieren in AWS SAM-Voraussetzungen.

In diesem Schritt verwenden Sie die AWS SAM CLI, um Ihre Anwendung auf dem AWS Cloud bereitzustellen. Die AWS SAM CLI wird Folgendes tun:

  • Führt Sie durch die Konfiguration Ihrer Anwendungseinstellungen für die Bereitstellung.

  • Laden Sie Ihre Anwendungsdateien auf Amazon Simple Storage Service (Amazon S3) hoch.

  • Verwandeln Sie Ihre AWS SAM Vorlage in eine AWS CloudFormation Vorlage. Anschließend wird Ihre Vorlage in den AWS CloudFormation Dienst hochgeladen, um Ihre AWS Ressourcen bereitzustellen.

So stellen Sie Ihre -Anwendung bereit
  1. Führen Sie in Ihrer Befehlszeile aus dem sam-app Projektverzeichnis Folgendes aus:

    $ sam deploy --guided
  2. Folgen Sie dem interaktiven AWS SAM CLI-Flow, um Ihre Anwendungseinstellungen zu konfigurieren. Konfigurieren Sie Folgendes:

    1. Der AWS CloudFormationStack-Name — Ein Stack ist eine Sammlung von AWS Ressourcen, die Sie als einzelne Einheit verwalten können. Weitere Informationen finden Sie im AWS CloudFormationBenutzerhandbuch unter Arbeiten mit Stacks.

    2. Die AWS-Region, auf die Sie Ihren AWS CloudFormation Stack verteilen möchten. Weitere Informationen finden Sie unter AWS CloudFormation-Endpunkte im AWS CloudFormation-Benutzerhandbuch.

    3. Für dieses Tutorial sollten Sie die Bestätigung der Änderungen vor der Bereitstellung ablehnen.

    4. Erstellung von IAM-Rollen zulassen — Auf diese Weise können AWS SAM Sie die IAM-Rolle erstellen, die für die Interaktion zwischen Ihrer API-Gateway-Ressource und der Lambda-Funktionsressource erforderlich ist.

    5. Deaktivieren Sie für dieses Tutorial die Deaktivierung des Rollbacks.

    6. Zulassen HelloWorldFunctionohne Autorisierung definiert — Diese Meldung wird angezeigt, weil Ihr API Gateway-Endpunkt so konfiguriert ist, dass er ohne Autorisierung öffentlich zugänglich ist. Da dies die beabsichtigte Konfiguration für Ihre Hello World-Anwendung ist, lassen Sie die AWS SAM CLI fortfahren. Weitere Hinweise zur Konfiguration der Autorisierung finden Sie unterSteuern des Zugriffs auf API Gateway.

    7. Argumente in der Konfigurationsdatei speichern — Dadurch wird die samconfig.toml Datei Ihrer Anwendung mit Ihren Bereitstellungseinstellungen aktualisiert.

    8. Wählen Sie den Namen der Standardkonfigurationsdatei aus.

    9. Wählen Sie die Standardkonfigurationsumgebung aus.

    Im Folgenden finden Sie eine Beispielausgabe des sam deploy --guided interaktiven Flows:

    $ sam-app sam deploy --guided Configuring SAM deploy ====================== Looking for config file [samconfig.toml] : Found Reading default arguments : Success Setting default arguments for 'sam deploy' ========================================= Stack Name [sam-app]: AWS Region [us-west-2]: #Shows you resources changes to be deployed and require a 'Y' to initiate deploy Confirm changes before deploy [Y/n]: n #SAM needs permission to be able to create roles to connect to the resources in your template Allow SAM CLI IAM role creation [Y/n]: #Preserves the state of previously provisioned resources when an operation fails Disable rollback [y/N]: HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y Save arguments to configuration file [Y/n]: SAM configuration file [samconfig.toml]: SAM configuration environment [default]:
  3. Die AWS SAM CLI stellt Ihre Anwendung wie folgt bereit:

    • Die AWS SAM CLI erstellt einen Amazon S3-Bucket und lädt Ihr .aws-sam Verzeichnis hoch.

    • Die AWS SAM CLI wandelt Ihre AWS SAM Vorlage in den Dienst um AWS CloudFormation und lädt sie in den Dienst hoch. AWS CloudFormation

    • AWS CloudFormationstellt Ihre Ressourcen bereit.

    Während der Bereitstellung zeigt die AWS SAM CLI Ihren Fortschritt an. Das Folgende ist ein Beispiel für eine Ausgabe:

    Looking for resources needed for deployment:
    
        Managed S3 bucket: aws-sam-cli-managed-default-samclisourcebucket-1a4x26zbcdkqr
        A different default S3 bucket can be set in samconfig.toml
    
        Parameter "stack_name=sam-app" in [default.deploy.parameters] is defined as a global parameter [default.global.parameters].
        This parameter will be only saved under [default.global.parameters] in /Users/.../Demo/sam-tutorial1/sam-app/samconfig.toml.
    
        Saved arguments to config file
        Running 'sam deploy' for future deployments will use the parameters saved above.
        The above parameters can be changed by modifying samconfig.toml
        Learn more about samconfig.toml syntax at
        https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-config.html
    
    File with same data already exists at sam-app/da3c598813f1c2151579b73ad788cac8, skipping upload
    
        Deploying with following values
        ===============================
        Stack name                   : sam-app
        Region                       : us-west-2
        Confirm changeset            : False
        Disable rollback             : False
        Deployment s3 bucket         : aws-sam-cli-managed-default-samclisourcebucket-1a4x26zbcdkqr
        Capabilities                 : ["CAPABILITY_IAM"]
        Parameter overrides          : {}
        Signing Profiles             : {}
    
    Initiating deployment
    =====================
    
    File with same data already exists at sam-app/2bebf67c79f6a743cc5312f6dfc1efee.template, skipping upload
    
    
    Waiting for changeset to be created..
    
    CloudFormation stack changeset
    ---------------------------------------------------------------------------------------------------------------------------------------------
    Operation                           LogicalResourceId                   ResourceType                        Replacement
    ---------------------------------------------------------------------------------------------------------------------------------------------
    * Modify                            HelloWorldFunction                  AWS::Lambda::Function               False
    * Modify                            ServerlessRestApi                   AWS::ApiGateway::RestApi            False
    - Delete                            AwsSamAutoDependencyLayerNestedSt   AWS::CloudFormation::Stack          N/A
                                        ack
    ---------------------------------------------------------------------------------------------------------------------------------------------
    
    
    Changeset created successfully. arn:aws:cloudformation:us-west-2:012345678910:changeSet/samcli-deploy1678917603/22e05525-08f9-4c52-a2c4-f7f1fd055072
    
    
    2023-03-15 12:00:16 - Waiting for stack create/update to complete
    
    CloudFormation events from stack operations (refresh every 0.5 seconds)
    ---------------------------------------------------------------------------------------------------------------------------------------------
    ResourceStatus                      ResourceType                        LogicalResourceId                   ResourceStatusReason
    ---------------------------------------------------------------------------------------------------------------------------------------------
    UPDATE_IN_PROGRESS                  AWS::Lambda::Function               HelloWorldFunction                  -
    UPDATE_COMPLETE                     AWS::Lambda::Function               HelloWorldFunction                  -
    UPDATE_COMPLETE_CLEANUP_IN_PROGRE   AWS::CloudFormation::Stack          sam-app                             -
    SS
    DELETE_IN_PROGRESS                  AWS::CloudFormation::Stack          AwsSamAutoDependencyLayerNestedSt   -
                                                                            ack
    DELETE_COMPLETE                     AWS::CloudFormation::Stack          AwsSamAutoDependencyLayerNestedSt   -
                                                                            ack
    UPDATE_COMPLETE                     AWS::CloudFormation::Stack          sam-app                             -
    ---------------------------------------------------------------------------------------------------------------------------------------------
    
    CloudFormation outputs from deployed stack
    ----------------------------------------------------------------------------------------------------------------------------------------------
    Outputs
    ----------------------------------------------------------------------------------------------------------------------------------------------
    Key                 HelloWorldFunctionIamRole
    Description         Implicit IAM Role created for Hello World function
    Value               arn:aws:iam::012345678910:role/sam-app-HelloWorldFunctionRole-15GLOUR9LMT1W
    
    Key                 HelloWorldApi
    Description         API Gateway endpoint URL for Prod stage for Hello World function
    Value               https://<restapiid>.execute-api.us-west-2.amazonaws.com/Prod/hello/
    
    Key                 HelloWorldFunction
    Description         Hello World Lambda Function ARN
    Value               arn:aws:lambda:us-west-2:012345678910:function:sam-app-HelloWorldFunction-yQDNe17r9maD
    ----------------------------------------------------------------------------------------------------------------------------------------------
    
    
    Successfully created/updated stack - sam-app in us-west-2

Ihre Anwendung ist jetzt bereitgestellt und läuft in derAWS Cloud!

Schritt 4: Führen Sie Ihre Anwendung aus

In diesem Schritt senden Sie eine GET-Anfrage an Ihren API-Endpunkt und sehen Ihre Lambda-Funktionsausgabe.

Um Ihren API-Endpunktwert zu erhalten
  1. Suchen Sie anhand der Informationen, die von der AWS SAM CLI im vorherigen Schritt angezeigt wurden, nach dem Outputs Abschnitt. Suchen Sie in diesem Abschnitt nach Ihrer HelloWorldApi Ressource, um Ihren HTTP-Endpunktwert zu ermitteln. Das Folgende ist ein Beispiel für eine Ausgabe:

    ----------------------------------------------------------------------------------------------------------------------------------------------
    Outputs
    ----------------------------------------------------------------------------------------------------------------------------------------------
    ...
    Key                 HelloWorldApi
    Description         API Gateway endpoint URL for Prod stage for Hello World function
    Value               https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/
    ...
    ----------------------------------------------------------------------------------------------------------------------------------------------
  2. Alternativ können Sie den sam list endpoints --output json Befehl verwenden, um diese Informationen abzurufen. Das Folgende ist ein Beispiel für eine Ausgabe:

    $ sam list endpoints --output json 2023-03-15 12:39:19 Loading policies from IAM... 2023-03-15 12:39:25 Finished loading policies from IAM. [ { "LogicalResourceId": "HelloWorldFunction", "PhysicalResourceId": "sam-app-HelloWorldFunction-yQDNe17r9maD", "CloudEndpoint": "-", "Methods": "-" }, { "LogicalResourceId": "ServerlessRestApi", "PhysicalResourceId": "ets1gv8lxi", "CloudEndpoint": [ "https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod", "https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Stage" ], "Methods": [ "/hello['get']" ] } ]
Um deine Funktion aufzurufen
  • Senden Sie über Ihren Browser oder die Befehlszeile eine GET-Anfrage an Ihren API-Endpunkt. Im Folgenden finden Sie ein Beispiel mit dem Befehl curl:

    $ curl https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/ {"message": "hello world"}

Schritt 5: Interagiere mit deiner Funktion in der AWS Cloud

In diesem Schritt verwenden Sie die AWS SAM CLI, um Ihre Lambda-Funktion in der aufzurufen. AWS Cloud

Um Ihre Lambda-Funktion in der Cloud aufzurufen
  1. Notieren Sie sich Ihre Funktionen LogicalResourceId aus dem vorherigen Schritt. Das sollte es seinHelloWorldFunction.

  2. Führen Sie in Ihrer Befehlszeile aus dem sam-app Projektverzeichnis Folgendes aus:

    $ sam remote invoke HelloWorldFunction --stack-name sam-app
  3. Die AWS SAM CLI ruft Ihre Funktion in der Cloud auf und gibt eine Antwort zurück. Das Folgende ist ein Beispiel für eine Ausgabe:

    $ sam remote invoke HelloWorldFunction --stack-name sam-app Invoking Lambda Function HelloWorldFunction START RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9 Version: $LATEST END RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9 REPORT RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9 Duration: 6.62 ms Billed Duration: 7 ms Memory Size: 128 MB Max Memory Used: 67 MB Init Duration: 164.06 ms {"statusCode":200,"body":"{\"message\":\"hello world\"}"}%

Schritt 6: Modifizieren und synchronisieren Sie Ihre Anwendung mit dem AWS Cloud

In diesem Schritt verwenden Sie den AWS SAM sam sync --watch CLI-Befehl, um lokale Änderungen mit dem AWS Cloud zu synchronisieren.

Um Sam Sync zu verwenden
  1. Führen Sie in Ihrer Befehlszeile aus dem sam-app Projektverzeichnis Folgendes aus:

    $ sam sync --watch
  2. Die AWS SAM CLI fordert Sie auf, zu bestätigen, dass Sie einen Entwicklungs-Stack synchronisieren. Da der sam sync --watch Befehl lokale Änderungen automatisch AWS Cloud in Echtzeit an der implementiert, empfehlen wir ihn nur für Entwicklungsumgebungen.

    Die AWS SAM CLI führt eine erste Bereitstellung durch, bevor sie mit der Überwachung auf lokale Änderungen beginnt. Das Folgende ist ein Beispiel für eine Ausgabe:

    $ sam sync --watch The SAM CLI will use the AWS Lambda, Amazon API Gateway, and AWS StepFunctions APIs to upload your code without performing a CloudFormation deployment. This will cause drift in your CloudFormation stack. **The sync command should only be used against a development stack**. Confirm that you are synchronizing a development stack. Enter Y to proceed with the command, or enter N to cancel: [Y/n]: y Queued infra sync. Waiting for in progress code syncs to complete... Starting infra sync. Manifest is not changed for (HelloWorldFunction), running incremental build Building codeuri: /Users/.../Demo/sam-tutorial1/sam-app/hello_world runtime: python3.9 metadata: {} architecture: x86_64 functions: HelloWorldFunction Running PythonPipBuilder:CopySource Build Succeeded Successfully packaged artifacts and wrote output template to file /var/folders/45/5ct135bx3fn2551_ptl5g6_80000gr/T/tmpq3x9vh63. Execute the following command to deploy the packaged template sam deploy --template-file /var/folders/45/5ct135bx3fn2551_ptl5g6_80000gr/T/tmpq3x9vh63 --stack-name <YOUR STACK NAME> Deploying with following values =============================== Stack name : sam-app Region : us-west-2 Disable rollback : False Deployment s3 bucket : aws-sam-cli-managed-default-samclisourcebucket-1a4x26zbcdkqr Capabilities : ["CAPABILITY_NAMED_IAM", "CAPABILITY_AUTO_EXPAND"] Parameter overrides : {} Signing Profiles : null Initiating deployment ===================== 2023-03-15 13:10:05 - Waiting for stack create/update to complete CloudFormation events from stack operations (refresh every 0.5 seconds) --------------------------------------------------------------------------------------------------------------------------------------------- ResourceStatus ResourceType LogicalResourceId ResourceStatusReason --------------------------------------------------------------------------------------------------------------------------------------------- UPDATE_IN_PROGRESS AWS::CloudFormation::Stack sam-app Transformation succeeded CREATE_IN_PROGRESS AWS::CloudFormation::Stack AwsSamAutoDependencyLayerNestedSt - ack CREATE_IN_PROGRESS AWS::CloudFormation::Stack AwsSamAutoDependencyLayerNestedSt Resource creation Initiated ack CREATE_COMPLETE AWS::CloudFormation::Stack AwsSamAutoDependencyLayerNestedSt - ack UPDATE_IN_PROGRESS AWS::Lambda::Function HelloWorldFunction - UPDATE_COMPLETE AWS::Lambda::Function HelloWorldFunction - UPDATE_COMPLETE_CLEANUP_IN_PROGRE AWS::CloudFormation::Stack sam-app - SS UPDATE_COMPLETE AWS::CloudFormation::Stack sam-app - --------------------------------------------------------------------------------------------------------------------------------------------- CloudFormation outputs from deployed stack ---------------------------------------------------------------------------------------------------------------------------------------------- Outputs ---------------------------------------------------------------------------------------------------------------------------------------------- Key HelloWorldFunctionIamRole Description Implicit IAM Role created for Hello World function Value arn:aws:iam::012345678910:role/sam-app-HelloWorldFunctionRole-15GLOUR9LMT1W Key HelloWorldApi Description API Gateway endpoint URL for Prod stage for Hello World function Value https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/ Key HelloWorldFunction Description Hello World Lambda Function ARN Value arn:aws:lambda:us-west-2:012345678910:function:sam-app-HelloWorldFunction-yQDNe17r9maD ---------------------------------------------------------------------------------------------------------------------------------------------- Stack update succeeded. Sync infra completed. Infra sync completed. CodeTrigger not created as CodeUri or DefinitionUri is missing for ServerlessRestApi.

Als Nächstes ändern Sie Ihren Lambda-Funktionscode. Die AWS SAM CLI erkennt diese Änderung automatisch und synchronisiert Ihre Anwendung mit demAWS Cloud.

Um Ihre Anwendung zu ändern und zu synchronisieren
  1. Öffnen Sie die sam-app/hello_world/app.py Datei in der IDE Ihrer Wahl.

  2. Ändern Sie die message und speichern Sie Ihre Datei. Im Folgenden wird ein Beispiel gezeigt:

    import json ... def lambda_handler(event, context): ... return { "statusCode": 200, "body": json.dumps({ "message": "hello everyone!", ... }), }
  3. Die AWS SAM CLI erkennt Ihre Änderung und synchronisiert Ihre Anwendung mit dem. AWS Cloud Das Folgende ist ein Beispiel für eine Ausgabe:

    Syncing Lambda Function HelloWorldFunction...
    Manifest is not changed for (HelloWorldFunction), running incremental build
    Building codeuri: /Users/.../Demo/sam-tutorial1/sam-app/hello_world runtime: python3.9 metadata: {} architecture: x86_64 functions: HelloWorldFunction
    Running PythonPipBuilder:CopySource
    Finished syncing Lambda Function HelloWorldFunction.
  4. Um Ihre Änderung zu überprüfen, senden Sie erneut eine GET-Anfrage an Ihren API-Endpunkt.

    $ curl https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/ {"message": "hello everyone!"}

Schritt 7: (Optional) Testen Sie Ihre Anwendung lokal

Anmerkung

Dieser Schritt ist optional, da er Docker auf Ihrem lokalen Computer erforderlich ist.

Wichtig

Um die AWS SAM CLI für lokale Tests verwenden zu können, müssen Sie sie Docker installiert und konfiguriert haben. Weitere Informationen finden Sie unter Installieren von Docker.

In diesem Schritt verwenden Sie den AWS SAM sam local CLI-Befehl, um Ihre Anwendung lokal zu testen. Um dies zu erreichen, erstellt die AWS SAM CLI eine lokale Umgebung mithilfe vonDocker. Diese lokale Umgebung emuliert die cloudbasierte Ausführungsumgebung Ihrer Lambda-Funktion.

Dafür müssen Sie Folgendes tun:

  1. Erstellen Sie eine lokale Umgebung für Ihre Lambda-Funktion und rufen Sie sie auf.

  2. Hosten Sie Ihren HTTP-API-Endpunkt lokal und verwenden Sie ihn, um Ihre Lambda-Funktion aufzurufen.

Um Ihre Lambda-Funktion lokal aufzurufen
  1. Führen Sie in Ihrer Befehlszeile aus dem sam-app Projektverzeichnis Folgendes aus:

    $ sam local invoke
  2. Die AWS SAM CLI erstellt einen lokalen Docker Container und ruft Ihre Funktion auf. Das Folgende ist ein Beispiel für eine Ausgabe:

    $ sam local invoke Invoking app.lambda_handler (python3.9) Local image was not found. Removing rapid images for repo public.ecr.aws/sam/emulation-python3.9 Building image..................... Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/.../Demo/sam-tutorial1/sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated inside runtime container START RequestId: b046db01-2a00-415d-af97-35f3a02e9eb6 Version: $LATEST END RequestId: b046db01-2a00-415d-af97-35f3a02e9eb6 REPORT RequestId: b046db01-2a00-415d-af97-35f3a02e9eb6 Init Duration: 1.01 ms Duration: 633.45 ms Billed Duration: 634 ms Memory Size: 128 MB Max Memory Used: 128 MB {"statusCode": 200, "body": "{\"message\": \"hello world\"}"}
Um deine API lokal zu hosten
  1. Führen Sie in Ihrer Befehlszeile aus dem sam-app Projektverzeichnis Folgendes aus:

    $ sam local start-api
  2. Die AWS SAM CLI erstellt einen lokalen Docker Container für Ihre Lambda-Funktion und erstellt einen lokalen HTTP-Server, um Ihren API-Endpunkt zu simulieren. Das Folgende ist ein Beispiel für eine Ausgabe:

    $ sam local start-api Initializing the lambda functions containers. Local image is up-to-date Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/.../Demo/sam-tutorial1/sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated inside runtime container Containers Initialization is done. Mounting HelloWorldFunction at http://127.0.0.1:3000/hello [GET] You can now browse to the above endpoints to invoke your functions. You do not need to restart/reload SAM CLI while working on your functions, changes will be reflected instantly/automatically. If you used sam build before running local commands, you will need to re-run sam build for the changes to be picked up. You only need to restart SAM CLI if you update your AWS SAM template 2023-03-15 14:25:21 WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead. * Running on http://127.0.0.1:3000 2023-03-15 14:25:21 Press CTRL+C to quit
  3. Senden Sie mit Ihrem Browser oder der Befehlszeile eine GET-Anfrage an Ihren lokalen API-Endpunkt. Im Folgenden finden Sie ein Beispiel mit dem Befehl curl:

    $ curl http://127.0.0.1:3000/hello {"message": "hello world"}

Schritt 8: Löschen Sie Ihre Bewerbung aus dem AWS Cloud

In diesem Schritt verwenden Sie den AWS SAM sam delete CLI-Befehl, um Ihre Anwendung aus dem AWS Cloud zu löschen.

Um Ihre Bewerbung aus dem AWS Cloud
  1. Führen Sie in Ihrer Befehlszeile aus dem sam-app Projektverzeichnis Folgendes aus:

    $ sam delete
  2. Die AWS SAM CLI fordert Sie auf, dies zu bestätigen. Anschließend werden der Amazon S3-Bucket und der AWS CloudFormation Stack Ihrer Anwendung gelöscht. Das Folgende ist ein Beispiel für eine Ausgabe:

    $ sam delete Are you sure you want to delete the stack sam-app in the region us-west-2 ? [y/N]: y Are you sure you want to delete the folder sam-app in S3 which contains the artifacts? [y/N]: y - Deleting S3 object with key c6ce8fa8b5a97dd022ecd006536eb5a4 - Deleting S3 object with key 5d513a459d062d644f3b7dd0c8b56a2a.template - Deleting S3 object with key sam-app/2bebf67c79f6a743cc5312f6dfc1efee.template - Deleting S3 object with key sam-app/6b208d0e42ad15d1cee77d967834784b.template - Deleting S3 object with key sam-app/da3c598813f1c2151579b73ad788cac8 - Deleting S3 object with key sam-app/f798cdd93cee188a71d120f14a035b11 - Deleting Cloudformation stack sam-app Deleted successfully

Fehlerbehebung

Informationen zur Problembehandlung mit der AWS SAM CLI finden Sie unter. AWS SAMCLI-Fehlerbehebung

Weitere Informationen

Weitere Informationen AWS SAM finden Sie in den folgenden Ressourcen:

  • The Complete AWS SAM Workshop — Ein Workshop, der Ihnen viele der wichtigsten Funktionen beibringen soll, die er AWS SAM bietet.

  • Sessions with SAM — Videoserie, erstellt von unserem AWS Serverless Developer Advocate-Team zur VerwendungAWS SAM.

  • Serverless Land — Website, auf der die neuesten Informationen, Blogs, Videos, Code und Lernressourcen für AWS Serverless zusammengefasst sind.