Démarrage rapide : Publication d'applications

Pour initialiser l'application

1. Exécutez la commande suivante à l'invite de commande de la CLI AWS SAM.

   sam init --runtime python3.6 

2. Vérifiez le contenu du répertoire créé par la commande (sam-app/) :

   • template.yaml— Définit deuxAWS ressources requises par l'application Hello World : une fonction Lambda et un point de terminaison API Gateway qui prend en charge une opération GET. Le modèle définit également le mappage entre les deux ressources.

   • Contenu lié au code de l'application Hello World :

     • hello_world/répertoire — Contient le code de l'application, qui est renvoyéhello world lorsque vous l'exécutez.

   Note

   Pour cet exercice, le code de l'application est écrit en Python et vous spécifiez le moteur d'exécution dans la commande init. AWS Lambda prend en charge des langues supplémentaires pour créer du code d'application. Si vous spécifiez un autre moteur d'exécution pris en charge, la commande init fournit le code Hello World dans le langage spécifié et un fichier README.md que vous pouvez suivre pour ce langage. Pour de plus amples informations sur les runtimes pris en charge, veuillez consulter Environnement d'exécution Lambda et bibliothèques disponibles.

Pour tester l'application localement

1. Démarrez le point de terminaison API Gateway localement. Vous devez exécuter la commande suivante à partir du répertoire qui contient le fichier template.yaml.

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

   La commande renvoie un point de terminaison API Gateway auquel vous pouvez envoyer des demandes pour des tests locaux.

2. Testez l'application. Copiez l'URL du point de terminaison API Gateway, collez-la dans le navigateur et choisissez Enter. Voici un exemple d'URL de point de terminaison d'API Gatewayhttp://127.0.0.1:3000/hello.

   API Gateway appelle localement la fonction Lambda à laquelle le point de terminaison est mappé. La fonction Lambda s'exécute dans le conteneur Docker local et renvoiehello world. API Gateway renvoie une réponse au navigateur qui contient le texte.

1. Modifiez le fichier /hello_world/app.py pour remplacer la chaîne de message 'hello world' par 'Hello World!'.

2. Rechargez l'URL de test dans votre navigateur et observez la nouvelle chaîne.

Pour créer un package de déploiement Lambda

1. Ajoutez une section Metadata à votre fichier de modèle AWS SAM fournissant les informations requises sur l'application. Pour de plus amples informations sur la section Metadata des modèles AWS SAM, veuillez consulter Propriétés de la section des métadonnées de modèles AWS SAM dans le Guide du développeur AWS Serverless Application Model.

   Voici un exemple de section Metadata :

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

   LesReadmeUrl propriétésLicenseUrl et peuvent être des références à des fichiers locaux (comme dans l'exemple ci-dessus) ou des liens vers des compartiments Amazon S3 qui hébergent déjà ces artefacts.

2. Créez un compartiment S3 à l'emplacement où vous souhaitez enregistrer le code empaqueté. Si vous souhaitez utiliser un compartiment S3 existant, ignorez cette étape.

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

3. Créez le package de déploiement de la fonction Lambda en exécutant la commandepackageAWS SAM CLI suivante.

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

   La commande exécute les opérations suivantes :

   • Comprime le contenu duaws-sam/hello_world/ répertoire et le charge sur Amazon S3.

   • Télécharge le package de déploiement, le fichier README et le fichier LICENSE dans le compartiment Amazon S3 spécifié par l'--s3-bucketoption.

   • Affiche un nouveau fichier modèle, appelé packaged.yaml, que vous utilisez à l'étape suivante pour publier l'application AWS Serverless Application Repository. Le fichier depackaged.yaml modèle est similaire au fichier de modèle original (template.yaml) mais présente une différence significative : leCodeUriLicenseUrl, et lesReadmeUrl propriétés pointent vers le compartiment Amazon S3 et les objets qui contiennent les artefacts respectifs. L'extrait suivant d'un exemple de fichier de modèle packaged.yaml montre la propriété CodeUri :

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

Pour publier l'application sans serveur dans le répertoire AWS Serverless Application Repository

• Exécutez la commande suivante pour publier la nouvelle application AWS Serverless Application Repository avec la première version créée en tant que 0.0.1.

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