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.
Einführung in die Bereitstellung mit AWS SAM
Verwenden Sie das AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAM CLI) sam deploy Befehl zum Bereitstellen Ihrer serverlosen Anwendung auf AWS Cloud.
-
Für eine Einführung in die AWS SAM CLI, siehe Was ist der AWS SAM CLI?.
-
Für eine Liste von
sam deployBefehlsoptionen finden Sie unter sam deploy. -
Als Beispiel für die Verwendung
sam deploywährend eines typischen Entwicklungsablaufs finden Sie unter Schritt 3: Stellen Sie Ihre Anwendung auf dem bereit AWS Cloud.
Eine Vorlage kann IAM-Rollen und andere Ressourcen definieren, die sam deploy erstellt mit Ihren Anmeldeinformationen. Prüfen Sie die Vorlagen- und Konfigurationsdateien aller Projekte, die Sie vor der Bereitstellung nicht erstellt haben.
Themen
Voraussetzungen
Zu verwenden sam deploy, installieren Sie den AWS SAM CLI indem Sie Folgendes ausfüllen:
Vor der Verwendung sam deploy, wir empfehlen ein grundlegendes Verständnis der folgenden Aspekte:
Bereitstellen von Anwendungen mithilfe von Sam Deploy
Wenn Sie eine serverlose Anwendung zum ersten Mal bereitstellen, verwenden Sie den --guided Option. Die AWS SAM CLI führt Sie durch einen interaktiven Ablauf zur Konfiguration der Bereitstellungseinstellungen Ihrer Anwendung.
So stellen Sie eine Anwendung mithilfe des interaktiven Ablaufs bereit
-
Gehen Sie zum Stammverzeichnis Ihres Projekts. Dies ist derselbe Ort wie Ihr AWS SAM Vorlage.
$cdsam-app -
Führen Sie den folgenden Befehl aus:
$sam deploy --guided -
Während des interaktiven Ablaufs wird der AWS SAM CLI fordert Sie auf, Optionen zur Konfiguration der Bereitstellungseinstellungen Ihrer Anwendung anzugeben.
Klammern (
[ ]) geben Standardwerte an. Lassen Sie Ihre Antwort leer, um den Standardwert auszuwählen. Die Standardwerte werden aus den folgenden Konfigurationsdateien abgerufen:-
~/.aws/config— Ihr General AWS Kontoeinstellungen. -
~/.aws/credentials— Ihr AWS Anmeldedaten für Ihr Konto. -
— Die Konfigurationsdatei Ihres Projekts.<project>/samconfig.toml
Geben Sie Werte an, indem Sie die AWS SAM CLI fordert auf. Zum Beispiel können Sie eingeben
zum Ja,yzum nein, oder Zeichenkettenwerte.nDie AWS SAM CLI schreibt deine Antworten auf dein Projekt
samconfig.tomldatei. Für nachfolgende Bereitstellungen können Sie verwendensam deployzur Bereitstellung mithilfe dieser konfigurierten Werte. Um diese Werte neu zu konfigurieren, verwenden Siesam deploy --guidederneut oder ändern Sie direkt Ihre Konfigurationsdateien.Das Folgende ist eine Beispielausgabe:
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]:ENTER#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 -
-
Als nächstes AWS SAM CLI stellt Ihre Anwendung auf dem AWS Cloud. Während der Bereitstellung wird der Fortschritt in Ihrer Befehlszeile angezeigt. Im Folgenden sind die wichtigsten Phasen der Bereitstellung aufgeführt:
-
Für Anwendungen mit AWS Lambda Event Functions, die als ZIP-Dateiarchiv verpackt sind, AWS SAM CLI komprimiert das Paket und lädt es in einen Amazon Simple Storage Service (Amazon S3) -Bucket hoch. Falls erforderlich, die AWS SAM CLI erstellt einen neuen Bucket.
-
Für Anwendungen mit dem Lambda-Funktionspaket als Container-Image ist das AWS SAM CLI lädt das Bild in die Amazon Elastic Container Registry (Amazon ECR) hoch. Falls erforderlich, die AWS SAM CLI erstellt ein neues Repository.
-
Das AWS SAM CLI erstellt eine AWS CloudFormation Change Set und stellt Ihre Anwendung bereit CloudFormation als Stapel.
-
Das AWS SAM CLI ändert dein Deployed AWS SAM Vorlage mit der neuen
CodeUriWert für Ihre Lambda-Funktionen.
Das Folgende ist ein Beispiel für AWS SAM CLI Bereitstellungsausgabe:
Looking for resources needed for deployment: Managed S3 bucket: aws-sam-cli-managed-default-samclisam-s3-demo-bucket-1a4x26zbcdkqr A different default S3 bucket can be set in samconfig.toml and auto resolution of buckets turned off by setting resolve_s3=False 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/.../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 Uploading to sam-app-zip/da3c598813f1c2151579b73ad788cac8 262144 / 619839 (42.29%)Uploading to sam-app-zip/da3c598813f1c2151579b73ad788cac8 524288 / 619839 (84.58%)Uploading to sam-app-zip/da3c598813f1c2151579b73ad788cac8 619839 / 619839 (100.00%) Deploying with following values =============================== Stack name : sam-app Region : us-west-2 Confirm changeset : True Disable rollback : False Deployment s3 bucket : aws-sam-cli-managed-default-samclisam-s3-demo-bucket-1a4x26zbcdkqr Capabilities : ["CAPABILITY_IAM"] Parameter overrides : {} Signing Profiles : {} Initiating deployment ===================== Uploading to sam-app-zip/be84c20f868068e4dc4a2c11966edf2d.template 1212 / 1212 (100.00%) Waiting for changeset to be created.. CloudFormation stack changeset ------------------------------------------------------------------------------------------------- Operation LogicalResourceId ResourceType Replacement ------------------------------------------------------------------------------------------------- + Add HelloWorldFunctionHell AWS::Lambda::Permissio N/A oWorldPermissionProd n + Add HelloWorldFunctionRole AWS::IAM::Role N/A + Add HelloWorldFunction AWS::Lambda::Function N/A + Add ServerlessRestApiDeplo AWS::ApiGateway::Deplo N/A yment47fc2d5f9d yment + Add ServerlessRestApiProdS AWS::ApiGateway::Stage N/A tage + Add ServerlessRestApi AWS::ApiGateway::RestA N/A pi ------------------------------------------------------------------------------------------------- Changeset created successfully. arn:aws:cloudformation:us-west-2:012345678910:changeSet/samcli-deploy1680559234/d9f58a77-98bc-41cd-b9f4-433a5a450d7a Previewing CloudFormation changeset before deployment ====================================================== Deploy this changeset? [y/N]:y2023-04-03 12:00:50 - Waiting for stack create/update to complete CloudFormation events from stack operations (refresh every 5.0 seconds) ------------------------------------------------------------------------------------------------- ResourceStatus ResourceType LogicalResourceId ResourceStatusReason ------------------------------------------------------------------------------------------------- CREATE_IN_PROGRESS AWS::IAM::Role HelloWorldFunctionRole - CREATE_IN_PROGRESS AWS::IAM::Role HelloWorldFunctionRole Resource creation Initiated CREATE_COMPLETE AWS::IAM::Role HelloWorldFunctionRole - CREATE_IN_PROGRESS AWS::Lambda::Function HelloWorldFunction - CREATE_IN_PROGRESS AWS::Lambda::Function HelloWorldFunction Resource creation Initiated CREATE_COMPLETE AWS::Lambda::Function HelloWorldFunction - CREATE_IN_PROGRESS AWS::ApiGateway::RestA ServerlessRestApi - pi CREATE_IN_PROGRESS AWS::ApiGateway::RestA ServerlessRestApi Resource creation pi Initiated CREATE_COMPLETE AWS::ApiGateway::RestA ServerlessRestApi - pi CREATE_IN_PROGRESS AWS::Lambda::Permissio HelloWorldFunctionHell - n oWorldPermissionProd CREATE_IN_PROGRESS AWS::ApiGateway::Deplo ServerlessRestApiDeplo - yment yment47fc2d5f9d CREATE_IN_PROGRESS AWS::Lambda::Permissio HelloWorldFunctionHell Resource creation n oWorldPermissionProd Initiated CREATE_IN_PROGRESS AWS::ApiGateway::Deplo ServerlessRestApiDeplo Resource creation yment yment47fc2d5f9d Initiated CREATE_COMPLETE AWS::ApiGateway::Deplo ServerlessRestApiDeplo - yment yment47fc2d5f9d CREATE_IN_PROGRESS AWS::ApiGateway::Stage ServerlessRestApiProdS - tage CREATE_IN_PROGRESS AWS::ApiGateway::Stage ServerlessRestApiProdS Resource creation tage Initiated CREATE_COMPLETE AWS::ApiGateway::Stage ServerlessRestApiProdS - tage CREATE_COMPLETE AWS::Lambda::Permissio HelloWorldFunctionHell - n oWorldPermissionProd CREATE_COMPLETE AWS::CloudFormation::S sam-app-zip - tack ------------------------------------------------------------------------------------------------- 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-zip- HelloWorldFunctionRole-11ZOGSCG28H0M Key HelloWorldApi Description API Gateway endpoint URL for Prod stage for Hello World function Value https://njzfhdmls0.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-XPqNX4TBu7qn ------------------------------------------------------------------------------------------------- Successfully created/updated stack - sam-app-zip in us-west-2 -
-
Gehen Sie wie folgt vor, um Ihre bereitgestellte Anwendung anzuzeigen:
-
Öffnen Sie das CloudFormation Konsole direkt mit der URL https://console.aws.amazon.com/cloudformation
. -
Wählen Sie Stapel.
-
Identifizieren Sie Ihren Stack anhand des Anwendungsnamens und wählen Sie ihn aus.
-
Überprüfen Sie die Änderungen vor der Bereitstellung
Sie können das konfigurieren AWS SAM CLI um deine anzuzeigen CloudFormation Ändern Sie das Set und bitten Sie vor dem Einsatz um Bestätigung.
Um Änderungen vor der Bereitstellung zu bestätigen
-
Während
sam deploy --guided, geben Sie einYum die Änderungen vor der Bereitstellung zu bestätigen.#Shows you resources changes to be deployed and require a 'Y' to initiate deploy Confirm changes before deploy [Y/n]:
YAlternativ können Sie Ihre ändern
samconfig.tomlDatei mit den folgenden Angaben:[
default.deploy] [default.deploy.parameters] confirm_changeset = true -
Während der Bereitstellung AWS SAM CLI fordert Sie auf, die Änderungen vor der Bereitstellung zu bestätigen. Im Folgenden wird ein Beispiel gezeigt:
Waiting for changeset to be created.. CloudFormation stack changeset ------------------------------------------------------------------------------------------------- Operation LogicalResourceId ResourceType Replacement ------------------------------------------------------------------------------------------------- + Add HelloWorldFunctionHell AWS::Lambda::Permissio N/A oWorldPermissionProd n + Add HelloWorldFunctionRole AWS::IAM::Role N/A + Add HelloWorldFunction AWS::Lambda::Function N/A + Add ServerlessRestApiDeplo AWS::ApiGateway::Deplo N/A yment47fc2d5f9d yment + Add ServerlessRestApiProdS AWS::ApiGateway::Stage N/A tage + Add ServerlessRestApi AWS::ApiGateway::RestA N/A pi ------------------------------------------------------------------------------------------------- Changeset created successfully. arn:aws:cloudformation:us-west-2:012345678910:changeSet/samcli-deploy1680559234/d9f58a77-98bc-41cd-b9f4-433a5a450d7a Previewing CloudFormation changeset before deployment ====================================================== Deploy this changeset? [y/N]:y
Geben Sie während der Bereitstellung zusätzliche Parameter an
Sie können zusätzliche Parameterwerte angeben, die bei der Bereitstellung konfiguriert werden sollen. Sie tun dies, indem Sie Ihre ändern AWS SAM Vorlage und Konfiguration Ihres Parameterwerts während der Bereitstellung.
Um zusätzliche Parameter anzugeben
-
Ändern Sie das
ParametersAbschnitt Ihres AWS SAM Vorlage. Im Folgenden wird ein Beispiel gezeigt:AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 ... Globals: ... Parameters: DomainName: Type: String Default: example Description: Domain name -
Führen Sie
sam deploy --guided. Das Folgende ist eine Beispielausgabe: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-zip]:ENTERAWS Region [us-west-2]:ENTERParameter DomainName [example]:ENTER
Konfigurieren Sie die Codesignatur für Ihre Lambda-Eventfunktionen
Sie können die Codesignatur für Ihre Lambda-Funktionen bei der Bereitstellung konfigurieren. Sie tun dies, indem Sie Ihre ändern AWS SAM Vorlage und Konfiguration der Codesignatur während der Bereitstellung.
Um die Codesignatur zu konfigurieren
-
Spezifizieren
CodeSigningConfigArnin deinem AWS SAM Vorlage. Im Folgenden wird ein Beispiel gezeigt:AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 ... Resources: HelloWorldFunction: Type: AWS::Serverless::Function Properties: CodeUri: hello_world/ Handler: app.lambda_handler Runtime: python3.7 CodeSigningConfigArn:arn:aws:lambda:us-east-1:111122223333:code-signing-config:csc-12e12345db1234567 -
Führen Sie
sam deploy --guided. Die AWS SAM CLI fordert Sie auf, die Codesignatur zu konfigurieren. Das Folgende ist eine Beispielausgabe:#Found code signing configurations in your function definitions Do you want to sign your code? [Y/n]:
ENTER#Please provide signing profile details for the following functions & layers #Signing profile details for function 'HelloWorld' Signing Profile Name: Signing Profile Owner Account ID (optional): #Signing profile details for layer 'MyLayer', which is used by functions {'HelloWorld'} Signing Profile Name: Signing Profile Owner Account ID (optional):
Erstellen und Bereitstellen von Lambda-Webfunktionen
Sie können das einstellen CodeUri von einem AWS::Serverless::WebFunction in ein lokales Verzeichnis. Das AWS SAM CLI erstellt den Code mit sam build und lädt es auf Amazon S3 hoch, wenn Sie es ausführen sam deploy, sam sync, oder sam package.
Weil die Revisionen einer Web-Funktion ihren Code aus Amazon S3 lesen, solange sie existieren, sam deploy und sam sync Laden Sie den Web Function-Code in einen Amazon S3-Bucket für Ihren Anwendungsstapel hoch, anstatt in den verwalteten Bucket, den AWS SAM CLI verwendet für andere Artefakte.
Erstellung
sam build erstellt eine Web-Funktion auf die gleiche Weise wie eine Node.js Lambda-Event-Funktion mit diesen Unterschieden:
-
Das Bereitstellungspaket ist immer ein
.zipDateiarchiv, das für das erstellt wurdex86_64Architektur. -
Der Build behält immer Abhängigkeiten im Bereitstellungspaket bei, da Web Functions keine Ebenen verwenden können. Das gilt auch für
sam sync, wodurch ansonsten Abhängigkeiten auf eine automatisch erstellte Ebene verschoben werden.
Um den Code mit esbuild zu bündeln, setzen Sie BuildMethod: esbuild in der Ressource Metadata. Das EntryPoint Die Datei ist der Esbuild-Einstiegspunkt und der der erstellten Vorlage EntryPoint zeigt auf die gebündelte Datei. Beispielsweise wird src/server.ts zu server.js. Die Build-Eigenschaften, die Sie festlegen können, finden Sie unter Gebäude Node.js Lambda-Event-Funktionen mit esbuild AWS SAM.
Resources: MyWebFunction: Type: AWS::Serverless::WebFunction Properties: Runtime: nodejs24.x AuthType: IamAuth CodeUri: web/ EntryPoint: src/server.ts Metadata: BuildMethod: esbuild BuildProperties: Minify: true
Wo der Code hochgeladen wird
| Befehl | Der Web-Funktionscode wird hochgeladen in |
|---|---|
sam deploy --guided oder sam deploy --resolve-s3 |
Der Code-Bucket des Stacks. Mit --guided, das ist der Stackname, den Sie an der Eingabeaufforderung eingeben. |
sam sync |
Der Code-Bucket des Stacks. |
sam deploy, sam sync, oder sam package mit --s3-bucket |
Der Eimer, den Sie angeben. Siehe Verwenden Sie Ihren eigenen Bucket. |
sam package --resolve-s3 |
Wird nicht unterstützt. sam package hat keinen Stack, für den ein Code-Bucket erstellt werden könnte, daher wird ein Fehler zurückgegeben. Benutzen sam deploy, oder Pass --s3-bucket. |
EIN CodeUri das deutet bereits darauf hin, dass Amazon S3 nicht hochgeladen wurde und seinen Standort beibehält. Lambda-Ereignisfunktionen und andere Artefakte in derselben Vorlage verwenden weiterhin den verwalteten Bucket oder den von Ihnen angegebenen Bucket.
Der Code-Bucket des Stacks
Wenn Sie zum ersten Mal einen Stack mit einer Webfunktion bereitstellen, die lokalen Code enthält, AWS SAM CLI erstellt eine CloudFormation Stapel mit dem Namen . Es enthält einen Amazon S3-Bucket, der:stack-name-hash-WebFunctionCode
-
Hat die Versionierung aktiviert, sodass jede Revision die von ihr verwendete Objektversion anheften kann.
-
Verwendet serverseitige Verschlüsselung mit von Amazon S3 verwalteten Schlüsseln (SSE-S3).
-
Blockiert jeglichen öffentlichen Zugriff und lehnt Anfragen ab, die kein HTTPS verwenden.
-
Erlaubt
lambda.amazonaws.com.rproxy.goskope.comanrufens3:GetObjectunds3:GetObjectVersionnur für Änderungen der Webfunktion in Ihrem Konto.
Der Stack exportiert den Bucket-Namen und die verpackte Vorlage importiert ihn:
CodeUri: Bucket: !ImportValuestack-name-hash-WebFunctionCode-Bucket Key:object-keyVersion:object-version-id
Aufgrund dieses Imports CloudFormation löscht den Code-Bucket-Stack nicht, während jeder Stack, einschließlich eines verschachtelten Stacks, Code daraus liest.
Verwenden Sie Ihren eigenen Bucket
Wenn du bestanden hast --s3-bucket, der Eimer muss die Anforderungen von erfüllen AWS::Serverless::WebFunction. Bevor es etwas hochlädt, die AWS SAM CLI überprüft den Bucket:
-
Wenn für den Bucket die Versionierung nicht aktiviert ist, schlägt der Befehl fehl.
-
Wenn
--kms-key-idist ein AWS verwalteter Schlüssel, der Befehl schlägt fehl. Verwenden Sie einen vom Kunden verwalteten Schlüssel, dessen Schlüsselrichtlinie dies zulässtlambda.amazonaws.com.rproxy.goskope.comum anzurufenkms:Decrypt. -
Wenn die Bucket-Richtlinie oder die Schlüsselrichtlinie Lambda offenbar nicht erlaubt, den Code zu lesen, gibt der Befehl eine Warnung aus und fährt fort.
Ohne --kms-key-id, der AWS SAM CLI lädt den Code hoch mit SSE-S3, auch wenn die Standardverschlüsselung des Buckets verwendet AWS KMS.
Sam Sync verwenden
Jede Änderung am Code einer Web-Funktion erzeugt eine neue Revision, also sam sync
--watch schaut sich den Code der Webfunktion nicht an. Es druckt eine Notiz, wenn es gestartet wird, und Codeänderungen werden bei der nächsten Infrastruktursynchronisierung bereitgestellt.
Löschen
sam delete löscht den Stapel, leert dann den Code-Bucket und löscht den Code-Bucket-Stack.
Wenn eine Webfunktion den Stapel überlebt, lesen ihre Revisionen immer noch Code aus dem Bucket. Das passiert, wenn die Webfunktion oder ein verschachtelter Stapel, der sie enthält, DeletionPolicy: Retain oder ist aufgeführt in --retain-resources. In diesem Fall sam delete behält den Code-Bucket-Stack bei, aktiviert seinen Kündigungsschutz und listet die beibehaltenen Webfunktionen auf. Wenn Sie sie nicht mehr benötigen, deaktivieren Sie den Kündigungsschutz, leeren Sie den Bucket und löschen Sie den Stack.
Wenn ein früherer sam delete löschte den Stack, aber nicht den Code-Bucket-Stack, führe es aus sam delete nochmal, um es zu löschen.
Einschränkungen
-
Eine Webfunktion mit lokalem Code kann nicht generiert werden von
Fn::ForEach. Definiere es draußenFn::ForEach, oder stelle es einCodeUrizum Code, der bereits in Amazon S3 enthalten ist. Weitere Informationen finden Sie unter CloudFormation Unterstützung für Spracherweiterungen. -
Das
sam localBefehle führen keine Webfunktionen aus. Da eine Webfunktion ein HTTP-Server ist, können Sie sie wie jeden anderen lokal ausführen und testen Node.js Server, zum Beispiel mitnpm startodernode. Wenn Ihr Server seinen Host und Port aus dem liestserver.jsAWS_LAMBDA_HTTP_ENDPOINTUmgebungsvariable, legen Sie diese Variable fest, wenn Sie sie ausführen.
Bewährte Methoden
-
Bei der Verwendung
sam deploy, der AWS SAM CLI stellt die Build-Artefakte Ihrer Anwendung bereit, die sich im.aws-samVerzeichnis. Wenn Sie Änderungen an den Originaldateien Ihrer Anwendung vornehmen, führen Sie Folgendes aussam buildum das zu aktualisieren.aws-samVerzeichnis vor der Bereitstellung. -
Wenn Sie eine Anwendung zum ersten Mal bereitstellen, verwenden Sie
sam deploy --guidedum die Bereitstellungseinstellungen zu konfigurieren. Für nachfolgende Bereitstellungen können Siesam deployzur Bereitstellung mit Ihren konfigurierten Einstellungen.
Optionen für die Sam-Bereitstellung
Die folgenden Optionen werden häufig verwendet für sam deploy. Eine Liste aller Optionen finden Sie unter sam deploy.
Verwenden Sie den geführten interaktiven Ablauf, um Ihre Anwendung bereitzustellen
Verwenden Sie das --guided Option, um die Bereitstellungseinstellungen Ihrer Anwendung über einen interaktiven Ablauf zu konfigurieren. Im Folgenden wird ein Beispiel gezeigt:
$sam deploy --guided
Die Bereitstellungseinstellungen Ihrer Anwendung werden in Ihrem Projekt gespeichert samconfig.toml datei. Weitere Informationen hierzu finden Sie unter Konfigurieren Sie die Projekteinstellungen.
Fehlerbehebung
Um Fehler zu beheben AWS SAM CLI, siehe AWS SAM CLI Fehlerbehebung.
Beispiele
Stellen Sie eine Hello World-Anwendung bereit, die eine Lambda-Event-Funktion enthält, die als ZIP-Dateiarchiv verpackt ist
Ein Beispiel finden Sie unter Schritt 3: Stellen Sie Ihre Anwendung auf dem bereit AWS Cloud im Hello World-Anwendungs-Tutorial.
Stellen Sie eine Hello World-Anwendung bereit, die eine Lambda-Ereignisfunktion enthält, die als Container-Image verpackt ist
Zunächst verwenden wir sam init um unsere Hello World-Anwendung zu erstellen. Während des interaktiven Ablaufs wählen wir Python3.9 Laufzeit und Image Pakettyp.
$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 ... Template:1Use the most popular runtime and package type? (Python and zip) [y/N]:ENTERWhich runtime would you like to use? 1 - aot.dotnet7 (provided.al2) ... 15 - nodejs12.x 16 - python3.9 17 - python3.8 ... Runtime:16What package type would you like to use? 1 - Zip 2 - Image Package type:2Based on your selections, the only dependency manager available is pip. We will proceed copying the template using pip. ... Project name [sam-app]:ENTER----------------------- Generating application: ----------------------- Name: sam-app Base Image: amazon/python3.9-base Architectures: x86_64 Dependency Manager: pip Output Directory: . Configuration file: sam-app/samconfig.toml Next steps can be found in the README file at sam-app/README.md ...
Als nächstes cd in das Stammverzeichnis unseres Projekts und ausführen sam build. Das AWS SAM CLI erstellt unsere Lambda-Funktion lokal mit Docker.
sam-app $sam buildBuilding codeuri: /Users/.../sam-app runtime: None metadata: {'Dockerfile': 'Dockerfile', 'DockerContext': '/Users/.../sam-app/hello_world', 'DockerTag': 'python3.9-v1'} architecture: x86_64 functions: HelloWorldFunction Building image for HelloWorldFunction function Setting DockerBuildArgs: {} for HelloWorldFunction function Step 1/5 : FROM public.ecr.aws/lambda/python:3.9 ---> 0a5e3da309aa Step 2/5 : COPY requirements.txt ./ ---> abc4e82e85f9 Step 3/5 : RUN python3.9 -m pip install -r requirements.txt -t . ---> [Warning] The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested ---> Running in 43845e7aa22d Collecting requests Downloading requests-2.28.2-py3-none-any.whl (62 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 62.8/62.8 KB 829.5 kB/s eta 0:00:00 Collecting idna<4,>=2.5 Downloading idna-3.4-py3-none-any.whl (61 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 61.5/61.5 KB 2.4 MB/s eta 0:00:00 Collecting charset-normalizer<4,>=2 Downloading charset_normalizer-3.1.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (199 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 199.2/199.2 KB 2.1 MB/s eta 0:00:00 Collecting certifi>=2017.4.17 Downloading certifi-2022.12.7-py3-none-any.whl (155 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 155.3/155.3 KB 10.2 MB/s eta 0:00:00 Collecting urllib3<1.27,>=1.21.1 Downloading urllib3-1.26.15-py2.py3-none-any.whl (140 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 140.9/140.9 KB 9.1 MB/s eta 0:00:00 Installing collected packages: urllib3, idna, charset-normalizer, certifi, requests Successfully installed certifi-2022.12.7 charset-normalizer-3.1.0 idna-3.4 requests-2.28.2 urllib3-1.26.15 Removing intermediate container 43845e7aa22d ---> cab8ace899ce Step 4/5 : COPY app.py ./ ---> 4146f3cd69f2 Step 5/5 : CMD ["app.lambda_handler"] ---> [Warning] The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested ---> Running in f4131ddffb31 Removing intermediate container f4131ddffb31 ---> d2f5180b2154 Successfully built d2f5180b2154 Successfully tagged helloworldfunction:python3.9-v1 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
Als nächstes rennen wir sam deploy --guided um unsere Anwendung bereitzustellen. Das AWS SAM CLI führt uns durch die Konfiguration unserer Bereitstellungseinstellungen. Dann das AWS SAM CLI stellt unsere Anwendung auf dem AWS Cloud.
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]:ENTER#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]:ENTERLooking for resources needed for deployment: Managed S3 bucket: aws-sam-cli-managed-default-samclisam-s3-demo-bucket-1a4x26zbcdkqr A different default S3 bucket can be set in samconfig.toml and auto resolution of buckets turned off by setting resolve_s3=False 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/.../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 e95fc5e75742: Pushed d8df51e7bdd7: Pushed b1d0d7e0b34a: Pushed 0071317b94d8: Pushed d98f98baf147: Pushed 2d244e0816c6: Pushed eb2eeb1ebe42: Pushed a5ca065a3279: Pushed fe9e144829c9: Pushed helloworldfunction-d2f5180b2154-python3.9-v1: digest: sha256:cceb71401b47dc3007a7a1e1f2e0baf162999e0e6841d15954745ecc0c447533 size: 2206 Deploying with following values =============================== Stack name : sam-app Region : us-west-2 Confirm changeset : True Disable rollback : False Deployment image repository : { "HelloWorldFunction": "012345678910.dkr.ecr.us-west-2.amazonaws.com/samapp7427b055/helloworldfunction19d43fc4repo" } Deployment s3 bucket : aws-sam-cli-managed-default-samclisam-s3-demo-bucket-1a4x26zbcdkqr Capabilities : ["CAPABILITY_IAM"] Parameter overrides : {} Signing Profiles : {} Initiating deployment ===================== HelloWorldFunction may not have authorization defined. Uploading to sam-app/682ad27c7cf7a17c7f77a1688b0844f2.template 1328 / 1328 (100.00%) Waiting for changeset to be created.. CloudFormation stack changeset ------------------------------------------------------------------------------------------------- Operation LogicalResourceId ResourceType Replacement ------------------------------------------------------------------------------------------------- + Add HelloWorldFunctionHell AWS::Lambda::Permissio N/A oWorldPermissionProd n + Add HelloWorldFunctionRole AWS::IAM::Role N/A + Add HelloWorldFunction AWS::Lambda::Function N/A + Add ServerlessRestApiDeplo AWS::ApiGateway::Deplo N/A yment47fc2d5f9d yment + Add ServerlessRestApiProdS AWS::ApiGateway::Stage N/A tage + Add ServerlessRestApi AWS::ApiGateway::RestA N/A pi ------------------------------------------------------------------------------------------------- Changeset created successfully. arn:aws:cloudformation:us-west-2:012345678910:changeSet/samcli-deploy1680634124/0ffd4faf-2e2b-487e-b9e0-9116e8299ac4 Previewing CloudFormation changeset before deployment ====================================================== Deploy this changeset? [y/N]:y2023-04-04 08:49:15 - Waiting for stack create/update to complete CloudFormation events from stack operations (refresh every 5.0 seconds) ------------------------------------------------------------------------------------------------- ResourceStatus ResourceType LogicalResourceId ResourceStatusReason ------------------------------------------------------------------------------------------------- CREATE_IN_PROGRESS AWS::CloudFormation::S sam-app User Initiated tack CREATE_IN_PROGRESS AWS::IAM::Role HelloWorldFunctionRole - CREATE_IN_PROGRESS AWS::IAM::Role HelloWorldFunctionRole Resource creation Initiated CREATE_COMPLETE AWS::IAM::Role HelloWorldFunctionRole - CREATE_IN_PROGRESS AWS::Lambda::Function HelloWorldFunction - CREATE_IN_PROGRESS AWS::Lambda::Function HelloWorldFunction Resource creation Initiated CREATE_COMPLETE AWS::Lambda::Function HelloWorldFunction - CREATE_IN_PROGRESS AWS::ApiGateway::RestA ServerlessRestApi - pi CREATE_IN_PROGRESS AWS::ApiGateway::RestA ServerlessRestApi Resource creation pi Initiated CREATE_COMPLETE AWS::ApiGateway::RestA ServerlessRestApi - pi CREATE_IN_PROGRESS AWS::Lambda::Permissio HelloWorldFunctionHell - n oWorldPermissionProd CREATE_IN_PROGRESS AWS::ApiGateway::Deplo ServerlessRestApiDeplo - yment yment47fc2d5f9d CREATE_IN_PROGRESS AWS::Lambda::Permissio HelloWorldFunctionHell Resource creation n oWorldPermissionProd Initiated CREATE_IN_PROGRESS AWS::ApiGateway::Deplo ServerlessRestApiDeplo Resource creation yment yment47fc2d5f9d Initiated CREATE_COMPLETE AWS::ApiGateway::Deplo ServerlessRestApiDeplo - yment yment47fc2d5f9d CREATE_IN_PROGRESS AWS::ApiGateway::Stage ServerlessRestApiProdS - tage CREATE_IN_PROGRESS AWS::ApiGateway::Stage ServerlessRestApiProdS Resource creation tage Initiated CREATE_COMPLETE AWS::ApiGateway::Stage ServerlessRestApiProdS - tage CREATE_COMPLETE AWS::Lambda::Permissio HelloWorldFunctionHell - n oWorldPermissionProd CREATE_COMPLETE AWS::CloudFormation::S sam-app - tack ------------------------------------------------------------------------------------------------- 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-JFML1JOKHJ71 Key HelloWorldApi Description API Gateway endpoint URL for Prod stage for Hello World function Value https://endlwiqqod.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- kyg6Y2iNRUPg ------------------------------------------------------------------------------------------------- Successfully created/updated stack - sam-app in us-west-2
Weitere Informationen
Um mehr über die Verwendung von zu erfahren AWS SAM CLI sam deploy Befehl, siehe Folgendes:
-
Das Komplette AWS SAM Workshop: Modul 3 — Manuelles Bereitstellen
— Erfahren Sie, wie Sie eine serverlose Anwendung mithilfe der erstellen, paketieren und bereitstellen AWS SAM CLI.