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 ModelBefehlszeilenschnittstelle (AWS SAMCLI), um Folgendes durchzuführen:
-
Initialisieren, erstellen und stellen Sie eine Hello World-Beispielanwendung bereit.
-
Nehmen Sie lokale Änderungen vor und synchronisieren Sie mit AWS CloudFormation.
-
Testen Sie Ihre Anwendung in der AWS Cloud.
-
Führen Sie optional lokale Tests auf Ihrem Entwicklungshost durch.
-
Löschen Sie die Beispielanwendung aus der AWS Cloud.
Die Hello World-Beispielanwendung implementiert ein grundlegendes API-Backend. Sie besteht aus den folgenden Ressourcen:
-
Amazon API Gateway – API-Endpunkt, mit dem Sie Ihre Funktion aufrufen.
-
AWS Lambda – Funktion, die die HTTP-API-GET-Anforderung verarbeitet und eine
hello worldNachricht zurückgibt. -
AWS Identity and Access Management (IAM)-Rolle – Stellt Berechtigungen für die Services zur sicheren Interaktion bereit.
Das folgende Diagramm zeigt die Komponenten dieser Anwendung:
Themen
- Voraussetzungen
- Schritt 1: Initialisieren der Hello World-Beispielanwendung
- Schritt 2: Erstellen Ihrer Anwendung
- Schritt 3: Bereitstellen Ihrer Anwendung in der AWS Cloud
- Schritt 4: Ausführen Ihrer Anwendung
- Schritt 5: Interagieren mit Ihrer Funktion in der AWS Cloud
- Schritt 6: Ändern und Synchronisieren Ihrer Anwendung mit der AWS Cloud
- Schritt 7: (Optional) Testen Ihrer Anwendung lokal
- Schritt 8: Löschen Ihrer Anwendung aus der AWS Cloud
- Fehlerbehebung
- Weitere Informationen
Voraussetzungen
Stellen Sie sicher, dass Sie Folgendes abgeschlossen haben:
Schritt 1: Initialisieren der Hello World-Beispielanwendung
In diesem Schritt verwenden Sie die , AWS SAMCLI um ein Beispiel für ein Hello World-Anwendungsprojekt auf Ihrem lokalen Computer zu erstellen.
So initialisieren Sie die Hello World-Beispielanwendung
-
Führen Sie in Ihrer Befehlszeile Folgendes aus einem Startverzeichnis Ihrer Wahl aus:
$sam init -
Die AWS SAMCLI führt Sie durch die Initialisierung einer neuen Anwendung. Konfigurieren Sie Folgendes:
-
Wählen Sie AWS Schnellstartvorlagen aus, um eine Startvorlage auszuwählen.
-
Wählen Sie die Vorlage Hello World Example aus und laden Sie sie herunter.
-
Verwenden Sie die Python Laufzeit und den
zipPakettyp. -
Deaktivieren Sie für dieses Tutorial die AWS X-Ray Nachverfolgung. Weitere Informationen finden Sie unter Was ist AWS X-Ray? im AWS X-Ray -Entwicklerhandbuch.
-
Deaktivieren Sie für dieses Tutorial die Überwachung mit Amazon CloudWatch Application Insights. Weitere Informationen finden Sie unter Amazon CloudWatch Application Insights im Amazon- CloudWatch Benutzerhandbuch.
-
Benennen Sie Ihre Anwendung als sam-app .
So verwenden Sie den AWS SAMCLI interaktiven Flow:
-
Eckige Klammern (
[ ]) geben Standardwerte an. Lassen Sie Ihre Antwort leer, um den Standardwert auszuwählen. -
Geben Sie
yn
Im Folgenden finden Sie ein Beispiel für den
sam initinteraktiven Flow:$sam init...Which template source would you like to use? 1 - AWS Quick Start Templates 2 - Custom Template Location Choice:1Choose 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:1Use the most popular runtime and package type? (Python and zip) [y/N]:yWould you like to enable X-Ray tracing on the function(s) in your application? [y/N]:ENTERWould 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]:ENTERProject name [sam-app]:ENTER -
-
Die lädt Ihre Startvorlage AWS SAMCLI herunter und erstellt die Verzeichnisstruktur des Anwendungsprojekts auf Ihrem lokalen Computer. Im Folgenden finden Sie ein Beispiel für die AWS SAMCLI 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 -
Verschieben Sie von Ihrer Befehlszeile in das neu erstellte
sam-appVerzeichnis. Im Folgenden finden Sie ein Beispiel dafür, was das erstellt AWS SAMCLI 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 filesEinige wichtige Dateien, die hervorgehoben werden 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 vom verwendeten Standardparameter gespeichert werdenAWS SAMCLI. -
template.yaml– Die AWS SAM Vorlage, die Ihren Anwendungsinfrastrukturcode enthält.
-
Sie haben jetzt eine vollständig erstellte Serverless-Anwendung auf Ihrem lokalen Computer!
Schritt 2: Erstellen Ihrer Anwendung
In diesem Schritt verwenden Sie die , AWS SAMCLI um Ihre Anwendung zu erstellen und sich auf die Bereitstellung vorzubereiten. Wenn Sie erstellen, AWS SAMCLI erstellt das ein .aws-sam Verzeichnis und organisiert dort Ihre Funktionsabhängigkeiten, den Projektcode und die Projektdateien.
So erstellen Sie Ihre Anwendung
-
Führen Sie in Ihrer Befehlszeile im
sam-appProjektverzeichnis Folgendes aus:$sam buildAnmerkung
Wenn Sie nicht Python auf Ihrem lokalen Computer haben, verwenden Sie stattdessen den sam build --use-container Befehl . Der AWS SAMCLI erstellt einen Docker Container, der die Laufzeit und Abhängigkeiten Ihrer Funktion enthält. Dieser Befehl erfordert Docker auf Ihrem lokalen Computer. Informationen zur Installation von Dockerfinden Sie unter Installieren von Docker.
Im Folgenden finden Sie ein Beispiel für die AWS SAMCLI Ausgabe:
$sam buildStarting 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 --guidedIm Folgenden finden Sie ein verkürztes Beispiel für das von der AWS SAM CLI erstellte
.aws-samVerzeichnis:.aws-sam ├── build │ ├── HelloWorldFunction │ │ ├── __init__.py │ │ ├── app.py │ │ └── requirements.txt │ └── template.yaml └── build.toml
Einige wichtige Dateien, die hervorgehoben werden sollten:
-
build/HelloWorldFunction– Enthält Ihren Lambda-Funktionscode und Ihre Abhängigkeiten. Der AWS SAMCLI erstellt ein Verzeichnis für jede Funktion in Ihrer Anwendung. -
build/template.yaml– Enthält eine Kopie Ihrer AWS SAM Vorlage, auf die von AWS CloudFormation bei der Bereitstellung verwiesen wird. -
build.toml– Konfigurationsdatei, in der die Standardparameterwerte gespeichert werden, auf die das AWS SAMCLI beim Erstellen und Bereitstellen Ihrer Anwendung verweist.
Sie können Ihre Anwendung jetzt in der bereitstellenAWS Cloud.
Schritt 3: Bereitstellen Ihrer Anwendung in der AWS Cloud
Anmerkung
Dieser Schritt erfordert die Konfiguration der AWS Anmeldeinformationen. Weitere Informationen finden Sie unter Schritt 5: Verwenden der AWS CLI zum Konfigurieren von AWS Anmeldeinformationen in AWS SAM-Voraussetzungen.
In diesem Schritt verwenden Sie die , AWS SAMCLI um Ihre Anwendung in der bereitzustellenAWS Cloud. Der AWS SAMCLI führt Folgendes aus:
-
Führen Sie Sie durch die Konfiguration Ihrer Anwendungseinstellungen für die Bereitstellung.
-
Laden Sie Ihre Anwendungsdateien in Amazon Simple Storage Service (Amazon S3) hoch.
-
Transformieren Sie Ihre AWS SAM Vorlage in eine -AWS CloudFormationVorlage. Anschließend lädt es Ihre Vorlage in den AWS CloudFormation Service hoch, um Ihre AWS Ressourcen bereitzustellen.
So stellen Sie Ihre -Anwendung bereit
-
Führen Sie in Ihrer Befehlszeile im
sam-appProjektverzeichnis Folgendes aus:$sam deploy --guided -
Folgen Sie dem AWS SAMCLI interaktiven Flow, um Ihre Anwendungseinstellungen zu konfigurieren. Konfigurieren Sie Folgendes:
-
Der AWS CloudFormationStack-Name – Ein Stack ist eine Sammlung von AWS Ressourcen, die Sie als einzelne Einheit verwalten können. Weitere Informationen finden Sie unter Arbeiten mit Stacks im AWS CloudFormation -Benutzerhandbuch.
-
Die AWS-Region, in der Ihr AWS CloudFormationStack bereitgestellt werden soll. Weitere Informationen finden Sie unter AWS CloudFormation-Endpunkte im AWS CloudFormation-Benutzerhandbuch.
-
Deaktivieren Sie für dieses Tutorial die Bestätigung von Änderungen, bevor Sie bereitstellen.
-
IAM-Rollenerstellung zulassen – Auf diese Weise können Sie die IAM-Rolle AWS SAM erstellen, die für Ihre API Gateway-Ressource und Lambda-Funktionsressource erforderlich ist, um zu interagieren.
-
Deaktivieren Sie für dieses Tutorial das Rollback von .
-
Zulassen HelloWorldFunction ohne Autorisierung definiert – Diese Meldung wird angezeigt, da Ihr API Gateway-Endpunkt so konfiguriert ist, dass er öffentlich und ohne Autorisierung zugänglich ist. Da dies die beabsichtigte Konfiguration für Ihre Hello-World-Anwendung ist, lassen Sie AWS SAMCLI zu, dass der fortgesetzt wird. Weitere Informationen zur Konfiguration der Autorisierung finden Sie unter Steuern des Zugriffs auf API Gateway Gateway-APIs.
-
Argumente in der Konfigurationsdatei speichern – Dadurch wird die
samconfig.tomlDatei Ihrer Anwendung mit Ihren Bereitstellungseinstellungen aktualisiert. -
Wählen Sie den Namen der Standardkonfigurationsdatei aus.
-
Wählen Sie die Standardkonfigurationsumgebung aus.
Im Folgenden finden Sie eine Beispielausgabe des
sam deploy --guidedinteraktiven Flows:$sam-app sam deploy --guidedConfiguring SAM deploy ====================== Looking for config file [samconfig.toml] : Found Reading default arguments : Success Setting default arguments for 'sam deploy' ========================================= Stack Name [sam-app]:ENTERAWS Region [us-west-2]:ENTER#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]:ENTER#Preserves the state of previously provisioned resources when an operation fails Disable rollback [y/N]:ENTERHelloWorldFunction may not have authorization defined, Is this okay? [y/N]:ySave arguments to configuration file [Y/n]:ENTERSAM configuration file [samconfig.toml]:ENTERSAM configuration environment [default]:ENTER -
-
Die stellt Ihre Anwendung wie folgt AWS SAMCLI bereit:
-
Der AWS SAMCLI erstellt einen Amazon S3-Bucket und lädt Ihr
.aws-samVerzeichnis hoch. -
Die AWS SAMCLI wandelt Ihre AWS SAM Vorlage in um AWS CloudFormation und lädt sie in den AWS CloudFormation Service hoch.
-
AWS CloudFormation stellt Ihre -Ressourcen bereit.
Während der Bereitstellung AWS SAMCLI zeigt die Ihren Fortschritt an. Im Folgenden finden Sie eine Beispielausgabe:
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 wird jetzt in der bereitgestellt und ausgeführtAWS Cloud.
Schritt 4: Ausführen Ihrer Anwendung
In diesem Schritt senden Sie eine GET-Anforderung an Ihren API-Endpunkt und sehen Ihre Lambda-Funktionsausgabe.
So rufen Sie Ihren API-Endpunktwert ab
-
Suchen Sie in den Informationen, die von der AWS SAMCLI im vorherigen Schritt angezeigt wurden, den
OutputsAbschnitt . Suchen Sie in diesem Abschnitt nach IhrerHelloWorldApiRessource, um Ihren HTTP-Endpunktwert zu finden. Im Folgenden finden Sie eine Beispielausgabe:---------------------------------------------------------------------------------------------------------------------------------------------- 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/ ... ----------------------------------------------------------------------------------------------------------------------------------------------
-
Alternativ können Sie diese Informationen auch mit dem sam list endpoints --output json Befehl abrufen. Im Folgenden finden Sie eine Beispielausgabe:
$sam list endpoints --output json2023-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']" ] } ]
So rufen Sie Ihre Funktion auf
-
Senden Sie über Ihren Browser oder die Befehlszeile eine GET-Anforderung 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: Interagieren mit Ihrer Funktion in der AWS Cloud
In diesem Schritt verwenden Sie die , AWS SAMCLI um Ihre Lambda-Funktion in der aufzurufenAWS Cloud.
So rufen Sie Ihre Lambda-Funktion in der Cloud auf
-
Notieren Sie sich die Ihrer Funktion
LogicalResourceIdaus dem vorherigen Schritt. Es sollte seinHelloWorldFunction. -
Führen Sie in Ihrer Befehlszeile im
sam-appProjektverzeichnis Folgendes aus:$sam remote invokeHelloWorldFunction--stack-namesam-app -
Der AWS SAMCLI ruft Ihre Funktion in der Cloud auf und gibt eine Antwort zurück. Im Folgenden finden Sie eine Beispielausgabe:
$sam remote invoke HelloWorldFunction --stack-name sam-appInvoking 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: Ändern und Synchronisieren Ihrer Anwendung mit der AWS Cloud
In diesem Schritt verwenden Sie den AWS SAMCLI sam sync --watch Befehl , um lokale Änderungen mit der zu synchronisierenAWS Cloud.
So verwenden Sie sam sync
-
Führen Sie in Ihrer Befehlszeile im
sam-appProjektverzeichnis Folgendes aus:$sam sync --watch -
Die AWS SAMCLI 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 in der bereitstellt, empfehlen wir sie nur für Entwicklungsumgebungen.
Der AWS SAMCLI führt eine erste Bereitstellung durch, bevor er mit der Überwachung lokaler Änderungen beginnt. Im Folgenden finden Sie eine Beispielausgabe:
$sam sync --watchThe 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]:yQueued 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 erkennt diese Änderung AWS SAMCLI automatisch und synchronisiert Ihre Anwendung mit der AWS Cloud.
So ändern und synchronisieren Sie Ihre Anwendung
-
Öffnen Sie die
sam-app/hello_world/app.pyDatei in Ihrer IDE Ihrer Wahl. -
Ändern Sie die
messageund 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!",...}), } -
Der AWS SAMCLI erkennt Ihre Änderung und synchronisiert Ihre Anwendung mit dem AWS Cloud. Im Folgenden finden Sie eine Beispielausgabe:
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. -
Um Ihre Änderung zu überprüfen, senden Sie erneut eine GET-Anforderung an Ihren API-Endpunkt.
$curl https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/{"message": "hello everyone!"}
Schritt 7: (Optional) Testen Ihrer Anwendung lokal
Anmerkung
Dieser Schritt ist optional, da er Docker auf Ihrem lokalen Computer benötigt.
Wichtig
Um die AWS SAMCLI für lokale Tests verwenden zu können, müssen Sie Docker installiert und konfiguriert haben. Weitere Informationen finden Sie unter Installieren von Docker.
In diesem Schritt verwenden Sie den AWS SAMCLI sam local Befehl , um Ihre Anwendung lokal zu testen. Um dies zu erreichen, AWS SAMCLI erstellt die eine lokale Umgebung mit Docker. Diese lokale Umgebung emuliert die cloudbasierte Ausführungsumgebung Ihrer Lambda-Funktion.
Dafür müssen Sie Folgendes tun:
-
Erstellen Sie eine lokale Umgebung für Ihre Lambda-Funktion und rufen Sie sie auf.
-
Hosten Sie Ihren HTTP-API-Endpunkt lokal und verwenden Sie ihn, um Ihre Lambda-Funktion aufzurufen.
So rufen Sie Ihre Lambda-Funktion lokal auf
-
Führen Sie in Ihrer Befehlszeile im
sam-appProjektverzeichnis Folgendes aus:$sam local invoke -
Der AWS SAMCLI erstellt einen lokalen Docker Container und ruft Ihre Funktion auf. Im Folgenden finden Sie eine Beispielausgabe:
$sam local invokeInvoking 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\"}"}
So hosten Sie Ihre API lokal
-
Führen Sie in Ihrer Befehlszeile im
sam-appProjektverzeichnis Folgendes aus:$sam local start-api -
Der AWS SAMCLI erstellt einen lokalen Docker Container für Ihre Lambda-Funktion und erstellt einen lokalen HTTP-Server zur Simulation Ihres API-Endpunkts. Im Folgenden finden Sie eine Beispielausgabe:
$sam local start-apiInitializing 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 -
Senden Sie über Ihren Browser oder die Befehlszeile eine GET-Anforderung 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 Ihrer Anwendung aus der AWS Cloud
In diesem Schritt verwenden Sie den AWS SAMCLI sam delete Befehl , um Ihre Anwendung aus der zu löschenAWS Cloud.
So löschen Sie Ihre Anwendung aus der AWS Cloud
-
Führen Sie in Ihrer Befehlszeile im
sam-appProjektverzeichnis Folgendes aus:$sam delete -
Der AWS SAMCLI wird Sie zur Bestätigung auffordern. Anschließend werden der Amazon S3-Bucket und -AWS CloudFormationStack Ihrer Anwendung gelöscht. Im Folgenden finden Sie eine Beispielausgabe:
$sam deleteAre you sure you want to delete the stack sam-app in the region us-west-2 ? [y/N]:yAre 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 Fehlerbehebung bei finden AWS SAMCLISie unter AWS SAMCLI Fehlerbehebung.
Weitere Informationen
Weitere Informationen zu finden AWS SAMSie in den folgenden Ressourcen:
-
Der Abschluss-AWS SAMWorkshop
– Ein Workshop, der Ihnen viele der wichtigsten Funktionen beibringen soll, die AWS SAM bietet. -
Sitzungen mit SAM
– Videoserie, die von unserem AWS Serverless Developer Advocate-Team zur Verwendung von erstellt wurdeAWS SAM. -
Serverless Land
– Website, die die neuesten Informationen, Blogs, Videos, Code und Lernressourcen für AWS Serverless zusammenfasst.
