Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Présentation du déploiement avec AWS SAM
Utilisez le AWS Serverless Application Model Interface de ligne de commande (AWS SAM CLI) sam deploy commande pour déployer votre application sans serveur sur AWS Cloud.
-
Pour une introduction à AWS SAM CLI, voir Qu'est-ce que AWS SAM INTERFACE DE LIGNE DE COMMANDE (CLI)?.
-
Pour obtenir la liste des options de commande
sam deploy, consultez déploiement sam. -
Pour un exemple d'utilisation de
sam deploydans le cadre d'un flux de travail de développement classique, consultez Étape 3 : Déployez votre application sur AWS Cloud.
Un modèle peut définir des rôles IAM et d'autres ressources qui sam deploy crée avec vos informations d'identification. Consultez le modèle et le fichier de configuration de tout projet que vous n'avez pas créé avant de le déployer.
Rubriques
Conditions préalables
Pour utiliser sam deploy, installez la CLI AWS SAM en procédant comme suit :
Avant d'utiliser sam deploy, nous vous recommandons d'avoir des connaissances de base sur les points suivants :
Déploiement d'applications avec sam deploy
Lorsque vous déployez une application sans serveur pour la première fois, utilisez l'option --guided. La CLI AWS SAM vous guidera à travers un flux interactif pour configurer les paramètres de déploiement de votre application.
Pour déployer une application à l'aide du flux interactif
-
Accédez au répertoire racine de votre projet. Il s'agit du même endroit que votre AWS SAM modèle.
$cdsam-app -
Exécutez la commande suivante :
$sam deploy --guided -
Au cours du flux interactif, la CLI AWS SAM vous invite à configurer les paramètres de déploiement de votre application.
Les crochets (
[ ]) indiquent les valeurs par défaut. Laissez la réponse vide pour sélectionner la valeur par défaut. Les valeurs par défaut sont obtenues à partir des fichiers de configuration suivants :-
~/.aws/config— Votre général AWS paramètres du compte. -
~/.aws/credentials— Votre AWS informations d'identification du compte. -
: le fichier de configuration de votre projet.<project>/samconfig.toml
Fournissez des valeurs en répondant aux invites de la CLI AWS SAM. Par exemple, vous pouvez saisir
pour oui,ypour non ou des valeurs de chaîne.nLa CLI AWS SAMécrit vos réponses dans le fichier
samconfig.tomlde votre projet. Pour les déploiements suivants, vous pouvez utilisersam deploypour déployer à l'aide de ces valeurs configurées. Pour reconfigurer ces valeurs, utilisez à nouveausam deploy --guidedou modifiez directement vos fichiers de configuration.Voici un exemple de résultat :
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 -
-
Ensuite, le AWS SAM CLI déploie votre application sur AWS Cloud. Pendant le déploiement, la progression s'affiche dans votre invite de commande. Les principales étapes du déploiement sont les suivantes :
-
Pour les applications avec AWS Lambda Fonctions événementielles regroupées sous forme d'archive de fichiers .zip, les AWS SAM CLI compresse et télécharge le package dans un compartiment Amazon Simple Storage Service (Amazon S3). Si nécessaire, la CLI AWS SAM créera un nouveau compartiment.
-
Pour les applications contenant un package de fonctions Lambda en tant qu'image de conteneur, la CLI AWS SAM charge l'image dans Amazon Elastic Container Registry (Amazon ECR). Si nécessaire, la CLI AWS SAM créera un nouveau référentiel.
-
Le AWS SAM CLI crée un AWS CloudFormation modifiez et déployez votre application sur CloudFormation sous forme de pile.
-
Le AWS SAM CLI modifie votre déploiement AWS SAM modèle avec le nouveau
CodeUrivaleur pour vos fonctions Lambda.
Vous trouverez ci-dessous un exemple du résultat du déploiement de la CLI AWS SAM :
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 -
-
Pour visualiser votre application déployée, procédez comme suit :
-
Ouvrez le CloudFormation console directement avec l'URL https://console.aws.amazon.com/cloudformation
. -
Sélectionner Piles
-
Identifiez votre pile par le nom de l'application et sélectionnez-la.
-
Vérifiez les modifications avant le déploiement
Vous pouvez configurer le AWS SAM CLI pour afficher votre CloudFormation modifiez l'ensemble et demandez une confirmation avant le déploiement.
Pour confirmer les modifications avant le déploiement
-
Lors de
sam deploy --guided, saisissezYpour confirmer les modifications avant le déploiement.#Shows you resources changes to be deployed and require a 'Y' to initiate deploy Confirm changes before deploy [Y/n]:
YVous pouvez également modifier votre fichier
samconfig.tomlcomme suit :[
default.deploy] [default.deploy.parameters] confirm_changeset = true -
Pendant le déploiement, la CLI AWS SAM vous demandera de confirmer les modifications avant le déploiement. Voici un exemple :
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
Spécifier des paramètres supplémentaires lors du déploiement
Vous pouvez spécifier des valeurs de paramètres supplémentaires à configurer lors du déploiement. Pour ce faire, modifiez votre modèle AWS SAM et configurez la valeur de votre paramètre pendant le déploiement.
Pour spécifier des paramètres supplémentaires
-
Modifiez le
Parameterssection de votre AWS SAM modèle. Voici un exemple :AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 ... Globals: ... Parameters: DomainName: Type: String Default: example Description: Domain name -
Exécutez
sam deploy --guided. Voici un exemple de résultat :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
Configurer la signature de code pour vos fonctions événementielles Lambda
Vous pouvez configurer la signature de code pour vos fonctions Lambda au moment du déploiement. Pour ce faire, modifiez votre AWS SAM modèle et configuration de la signature de code pendant le déploiement.
Pour configurer la signature de code
-
Spécifiez
CodeSigningConfigArndans votre AWS SAM modèle. Voici un exemple :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 -
Exécutez
sam deploy --guided. La CLI AWS SAM vous invite à configurer la signature de code. Voici un exemple de résultat :#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):
Création et déploiement de fonctions Web Lambda
Vous pouvez régler le CodeUri d'un AWS::Serverless::WebFunction vers un répertoire local. Le AWS SAM CLI construit le code avec sam build et le télécharge sur Amazon S3 lorsque vous exécutez sam deploy, sam sync, ou sam package.
Étant donné que les révisions d'une fonction Web lisent son code depuis Amazon S3 tant qu'elle existe, sam deploy et sam sync téléchargez le code Web Function dans un compartiment Amazon S3 pour votre pile d'applications, au lieu du compartiment géré que AWS SAM CLI utilisations pour d'autres objets.
Création
sam build crée une fonction Web de la même manière qu'elle crée une Node.js Fonction événementielle Lambda, avec les différences suivantes :
-
Le package de déploiement est toujours
.ziparchive de fichiers créée pourx86_64architecture. -
La version conserve toujours les dépendances dans le package de déploiement, car Web Functions ne peut pas utiliser de couches. Cela vaut également pour
sam sync, qui dans le cas contraire déplace les dépendances vers une couche créée automatiquement.
Pour regrouper le code avec esbuild, définissez BuildMethod: esbuild dans la ressource Metadata. Le EntryPoint le fichier est le point d'entrée esbuild et le modèle créé EntryPoint pointe vers le fichier groupé. Par exemple, src/server.ts devient server.js. Pour les propriétés de construction que vous pouvez définir, voir Bâtiment Node.js Fonctions événementielles Lambda avec 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
Où le code est téléchargé
| Commande | Le code de la fonction Web est chargé sur |
|---|---|
sam deploy --guided ou sam deploy --resolve-s3 |
Le compartiment de code de la pile. Avec --guided, il s'agit du nom de pile que vous entrez à l'invite. |
sam sync |
Le compartiment de code de la pile. |
sam deploy, sam sync, ou sam package avec --s3-bucket |
Le compartiment que vous spécifiez. Consultez Utiliser votre propre seau. |
sam package --resolve-s3 |
Non pris en charge. sam package n'a pas de pile pour laquelle créer un compartiment de code, il renvoie donc une erreur. Utiliser sam deploy, ou laissez-passer --s3-bucket. |
UNE CodeUri qui indique déjà qu'Amazon S3 n'est pas chargé et conserve sa position. Les fonctions événementielles Lambda et les autres artefacts du même modèle utilisent toujours le compartiment géré ou le compartiment que vous spécifiez.
Le compartiment de code de la pile
La première fois que vous déployez une pile avec une fonction Web contenant du code local, AWS SAM CLI crée un CloudFormation pile nommée . Il contient un compartiment Amazon S3 qui :stack-name-hash-WebFunctionCode
-
Le contrôle de version est activé, de sorte que chaque révision puisse épingler la version de l'objet qu'elle utilise.
-
Utilise un chiffrement côté serveur avec des clés gérées par Amazon S3 (SSE-S3).
-
Bloque tout accès public et refuse les requêtes qui n'utilisent pas le protocole HTTPS.
-
Permet
lambda.amazonaws.comappelers3:GetObjectets3:GetObjectVersionuniquement pour les révisions des fonctions Web de votre compte.
La pile exporte le nom du compartiment et le modèle packagé l'importe :
CodeUri: Bucket: !ImportValuestack-name-hash-WebFunctionCode-Bucket Key:object-keyVersion:object-version-id
En raison de cette importation, CloudFormation ne supprime pas la pile de compartiments de code lorsqu'aucune pile, y compris une pile imbriquée, lit le code qu'elle contient.
Utiliser votre propre seau
Quand tu passes --s3-bucket, le godet doit répondre aux exigences de AWS::Serverless::WebFunction. Avant de télécharger quoi que ce soit, AWS SAM CLI vérifie le compartiment :
-
Si le contrôle de version n'est pas activé pour le bucket, la commande échoue.
-
Si
--kms-key-idest un AWS clé gérée, la commande échoue. Utilisez une clé gérée par le client dont la politique de clé le permetlambda.amazonaws.comappelerkms:Decrypt. -
Si la politique de compartiment ou la politique de clé ne semble pas autoriser Lambda à lire le code, la commande affiche un avertissement et continue.
Sans --kms-key-id, le AWS SAM CLI télécharge le code avec SSE-S3, même si le chiffrement par défaut du bucket utilise AWS KMS.
Utilisation de Sam Sync
Chaque modification apportée au code d'une fonction Web crée une nouvelle révision, donc sam sync
--watch ne regarde pas le code Web Function. Il imprime une note au démarrage et les modifications de code sont déployées lors de la prochaine synchronisation de l'infrastructure.
Suppression
sam delete supprime la pile, puis vide le compartiment de code et supprime la pile de compartiments de code.
Si une fonction Web survit à la pile, ses révisions lisent toujours le code du bucket. Cela se produit lorsque la fonction Web, ou une pile imbriquée qui la contient, possède DeletionPolicy: Retain ou est répertorié dans --retain-resources. Dans ce cas, sam delete conserve la pile de compartiments de code, active sa protection de terminaison et répertorie les fonctions Web conservées. Lorsque vous n'en avez plus besoin, désactivez la protection contre les interruptions, videz le compartiment et supprimez la pile.
Si une date antérieure sam delete supprimé la pile mais pas la pile de compartiments de code, exécutez sam delete à nouveau pour le supprimer.
Limitations
-
Une fonction Web avec du code local ne peut pas être générée par
Fn::ForEach. Définissez-le à l'extérieurFn::ForEach, ou définissez sonCodeUripour coder qui se trouve déjà dans Amazon S3. Pour plus d’informations, consultez CloudFormation prise en charge des extensions de langue. -
Le
sam localles commandes n'exécutent pas les fonctions Web. Comme une fonction Web est un serveur HTTP, vous pouvez l'exécuter et la tester localement comme n'importe quelle autre Node.js serveur, par exemple avecnpm startounode. Si votre serveur lit son hôte et son port à partir duserver.jsAWS_LAMBDA_HTTP_ENDPOINTvariable d'environnement, définissez cette variable lorsque vous l'exécutez.
Bonnes pratiques
-
Lors de l'utilisation de
sam deploy, la AWS SAM CLI déploie les artefacts de création de votre application situés dans le répertoire.aws-sam. Lorsque vous apportez des modifications aux fichiers d'origine de votre application, exécutezsam buildpour mettre à jour le répertoire.aws-samavant de procéder au déploiement. -
Lorsque vous déployez une application pour la première fois, utilisez
sam deploy --guidedpour configurer les paramètres de déploiement. Pour les déploiements suivants, vous pouvez utilisersam deploypour déployer avec vos paramètres configurés.
Options pour sam deploy
Les options suivantes sont couramment utilisées pour sam deploy. Pour obtenir la liste de toutes les options, consultez déploiement sam.
Utiliser le flux interactif guidé pour déployer votre application
Utilisez l'option --guided pour configurer les paramètres de déploiement de votre application à travers un flux interactif. Voici un exemple :
$sam deploy --guided
Les paramètres de déploiement de votre application sont enregistrés dans le fichier samconfig.toml de votre projet. Pour en savoir plus, consultez Configuration des paramètres de projet.
Résolution des problèmes
Pour résoudre les problèmes AWS SAM CLI, voir AWS SAM INTERFACE DE LIGNE DE COMMANDE (CLI) résolution des problèmes.
Exemples
Déployez une application Hello World contenant une fonction événementielle Lambda empaquetée sous forme d'archive de fichier .zip
Pour un exemple, consultez Étape 3 : Déployez votre application sur AWS Cloud dans le didacticiel de l'application Hello World.
Déployez une application Hello World contenant une fonction d'événement Lambda présentée sous forme d'image de conteneur
Tout d'abord, nous l'utilisons sam init pour créer notre application Hello World. Au cours du flux interactif, nous sélectionnons l'exécution Python3.9 et le type de package Image.
$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 ...
Ensuite, nous cd vers le répertoire racine de notre projet et exécutons sam build. La CLI AWS SAM crée notre fonction Lambda localement en utilisant 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
Ensuite, nous exécutons sam deploy --guided pour déployer notre application. La CLI AWS SAM nous guide dans la configuration de nos paramètres de déploiement. Ensuite, le AWS SAM CLI déploie notre application sur 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
En savoir plus
Pour en savoir plus sur l'utilisation du AWS SAM CLI sam deploy commande, consultez les informations suivantes :
-
L'intégrale AWS SAM Atelier : Module 3 - Déploiement manuel
— Apprenez à créer, empaqueter et déployer une application sans serveur à l'aide du AWS SAM CLI.