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. # Déployer une fonction Lambda à l'aide de AWS SAM CodeBuild Lambda Java The AWS Serverless Application Model (AWS SAM) est un framework open source permettant de créer des applications sans serveur. Pour plus d'informations, consultez le [AWS Serverless Application Model référentiel](https://github.com/aws/serverless-application-model) sur GitHub. L'exemple Java suivant utilise Gradle pour créer et tester une AWS Lambda fonction. Ensuite, la AWS SAM CLI est utilisée pour déployer le CloudFormation modèle et le bundle de déploiement. Grâce à CodeBuild Lambda, les étapes de construction, de test et de déploiement sont toutes gérées automatiquement, ce qui permet de mettre à jour rapidement l'infrastructure sans intervention manuelle lors d'une seule génération. ## Configurez votre AWS SAM référentiel Créez un AWS SAM `Hello World` projet à l'aide de la AWS SAM CLI. **Pour créer votre AWS SAM projet** 1. Suivez les instructions du *guide du AWS Serverless Application Model développeur* pour [installer la AWS SAM CLI](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/install-sam-cli.html) sur votre machine locale. 1. Exécutez `sam init` et sélectionnez la configuration de projet suivante. ``` Which template source would you like to use?: 1 - AWS Quick Start Templates Choose an AWS Quick Start application template: 1 - Hello World Example Use the most popular runtime and package type? (Python and zip) [y/N]: N Which runtime would you like to use?: 8 - java21 What package type would you like to use?: 1 - Zip Which dependency manager would you like to use?: 1 - gradle Would you like to enable X-Ray tracing on the function(s) in your application? [y/N]: N Would you like to enable monitoring using CloudWatch Application Insights? [y/N]: N Would you like to set Structured Logging in JSON format on your Lambda functions? [y/N]: N Project name [sam-app]: ``` 1. Téléchargez le dossier AWS SAM du projet dans un référentiel source compatible. Pour obtenir la liste des types de sources pris en charge, consultez [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html). ## Création d'un projet CodeBuild Lambda Java Créez un projet AWS CodeBuild Lambda Java et configurez les autorisations IAM nécessaires pour le build. **Pour créer votre projet CodeBuild Lambda Java** 1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home). 1. Si une page CodeBuild d'informations s'affiche, choisissez **Create build project**. Sinon, dans le volet de navigation, développez **Build****, choisissez Build projects**, puis **Create build project**. 1. Dans **Nom du projet**, saisissez un nom pour ce projet de génération. Les noms des projets de construction doivent être uniques pour chaque AWS compte. Vous pouvez également inclure une description facultative du projet de construction pour aider les autres utilisateurs à comprendre à quoi sert ce projet. 1. Dans **Source**, sélectionnez le référentiel source dans lequel se trouve votre AWS SAM projet. 1. Dans **Environment (Environnement)** : + Pour **Compute**, sélectionnez **Lambda**. + Pour **Runtime (s)**, sélectionnez **Java**. + Pour **Image**, sélectionnez **aws/codebuild/amazonlinux-x86\$164-lambda-standard:corretto21**. + Pour **Rôle de service**, laissez l'option **Nouveau rôle de service** sélectionnée. Notez le **nom du rôle**. Cela sera nécessaire lorsque vous mettrez à jour les autorisations IAM du projet ultérieurement dans cet exemple. 1. Choisissez **Créer un projet de génération**. 1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Dans le volet de navigation, choisissez **Rôles** et sélectionnez le rôle de service associé à votre projet. Vous pouvez trouver votre rôle dans le projet en CodeBuild sélectionnant votre projet de construction, en choisissant **Modifier**, **Environnement**, puis **Rôle de service**. 1. Sélectionnez l'onglet **Trust relationships** (Relations d'approbation), puis **Edit trust policy** (Modifier la politique d'approbation). 1. Ajoutez la politique intégrée suivante à votre rôle IAM. Cela sera utilisé pour déployer votre AWS SAM infrastructure ultérieurement. Pour plus d’informations, consultez [Ajout et suppression d’autorisations basées sur l’identité IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dans le *Guide de l’utilisateur IAM*. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Action": [ "cloudformation:*", "lambda:*", "iam:*", "apigateway:*", "s3:*" ], "Resource": "arn:aws:iam::*:role/Service*" } ] } ``` ------ ## Configurer le buildspec du projet Pour créer, tester et déployer votre fonction Lambda, CodeBuild lit et exécute les commandes de construction à partir d'une spécification de construction. **Pour configurer le buildspec de votre projet** 1. Dans la CodeBuild console, sélectionnez votre projet de build, puis choisissez **Edit** et **Buildspec**. 1. Dans **Buildspec**, choisissez **Insérer des commandes de construction**, puis **Passer** à l'éditeur. 1. Supprimez les commandes de construction préremplies et collez les spécifications de construction suivantes. ``` version: 0.2 env: variables: GRADLE_DIR: "HelloWorldFunction" phases: build: commands: - echo "Running unit tests..." - cd $GRADLE_DIR; gradle test; cd .. - echo "Running build..." - sam build --template-file template.yaml - echo "Running deploy..." - sam package --output-template-file packaged.yaml --resolve-s3 --template-file template.yaml - yes | sam deploy ``` 1. Choisissez **Update buildspec (Mettre à jour buildspec)**. ## Déployez votre infrastructure AWS SAM Lambda Utilisez CodeBuild Lambda pour déployer automatiquement votre infrastructure Lambda **Pour déployer votre infrastructure Lambda** 1. Choisissez **Démarrer la génération**. Cela permettra de créer, de tester et de déployer automatiquement votre AWS SAM application pour AWS Lambda l'utiliser CloudFormation. 1. Une fois le build terminé, accédez à la AWS Lambda console et recherchez votre nouvelle fonction Lambda sous le nom du AWS SAM projet. 1. Testez votre fonction Lambda en sélectionnant **API Gateway** dans la vue d'ensemble des **fonctions**, puis en cliquant sur l'URL du point de **terminaison de l'API**. Vous devriez voir une page s'ouvrir avec le message`"message": "hello world"`. ## Nettoyez votre infrastructure Pour éviter des frais supplémentaires pour les ressources que vous avez utilisées au cours de ce didacticiel, supprimez les ressources créées par votre AWS SAM modèle et CodeBuild. **Pour nettoyer votre infrastructure** 1. Accédez à la CloudFormation console et sélectionnez le`aws-sam-cli-managed-default`. 1. Dans **Ressources**, videz le compartiment de déploiement`SamCliSourceBucket`. 1. Supprimez la `aws-sam-cli-managed-default` pile. 1. Supprimez la CloudFormation pile associée à votre AWS SAM projet. Cette pile doit porter le même nom que votre AWS SAM projet. 1. Accédez à la CloudWatch console et supprimez les groupes de CloudWatch journaux associés à votre CodeBuild projet. 1. Accédez à la CodeBuild console et supprimez votre CodeBuild projet en choisissant **Supprimer le projet de construction**.