AWS SAM Utilisation de la AWS boîte à outils

1. Dans l'AWS explorateur, ouvrez le menu contextuel (clic droit) du nœud Lambda, puis choisissez Create Lambda Application. SAM

   Note

   Vous pouvez également sélectionner l'icône du menu située en face de l'en-tête AWS: Explorer, puis choisir Create Lambda Application SAM.

2. Choisissez le moteur d'exécution de votre SAM application. Pour cet exemple, choisissez nodejs12.x.

   Note

   Si vous sélectionnez l'un des environnements d'exécution avec « (Image) », votre application est de type package Image. Si vous sélectionnez l'un des environnements d'exécution sans « (Image) », votre application est de type Zip. Pour plus d'informations sur la différence entre les types de packages Image et Zip, consultez Packages de déploiement Lambda dans le guide du développeur AWS Lambda .

3. Choisissez l'un des modèles suivants pour votre appli sans serveur :

   • AWS SAM Hello World : modèle de base doté d'une fonction Lambda qui renvoie le message classique « Hello World ».

   • AWS Exemple d'application Step Functions : exemple d'application qui exécute un flux de travail de négociation d'actions. Les Steps Functions orchestrent les interactions des fonctions Lambda impliquées.

4. Choisissez l'emplacement de votre nouveau projet. S'il est disponible, vous pouvez sélectionner un dossier d'espace de travail existant. Sinon, recherchez un autre dossier. Si vous choisissez Select a different folder (Sélectionner un autre dossier), une boîte de dialogue s'affiche pour vous permettre de sélectionner un emplacement de dossier.

5. Saisissez le nom de votre nouvelle application. Pour cet exemple, utilisez my-sam-app-nodejs. Une fois que vous avez appuyé sur Entrée, le AWS kit d'outils met quelques instants à créer le projet.

Pour utiliser un SAM modèle pour exécuter et déboguer une application sans serveur

1. Pour afficher les fichiers de votre application, qui composent votre application sans serveur, accédez à la fenêtre Environnement.

2. Dans le dossier de l'application (par exemple, my-sample-app), ouvrez le template.yaml fichier.

3. Pour template.yaml, sélectionnez Edit Launch Configuration (Modifier la configuration du lancement).

   Un nouvel éditeur affiche le fichier launch.json qui fournit une configuration de débogage avec des attributs par défaut.

4. Modifiez ou confirmez les valeurs des propriétés de configuration suivantes :

   • "name" : saisissez un nom convivial à afficher dans le champ déroulant Configuration dans la vue Run (Exécuter).

   • "target" : vérifiez que la valeur est "template". Ainsi, le SAM modèle est le point d'entrée de la session de débogage.

   • "templatePath" – Saisissez un chemin relatif ou absolu pour le fichier template.yaml.

   • "logicalId"— Assurez-vous que le nom correspond à celui spécifié dans la section Ressources du SAM modèle. Dans ce cas, il s'agit de HelloWorldFunction de type AWS::Serverless::Function.

   Pour plus d'informations sur ces entrées et sur d'autres entrées dans le fichier launch.json, consultez Options de configuration pour le débogage d'applications sans serveur.

5. Si la votre configuration de débogage vous convient, enregistrez launch.json. Ensuite, cliquez sur le bouton vert « play » à côté RUNpour démarrer le débogage.

   Note

   Si votre SAM application ne s'exécute pas, consultez la fenêtre de sortie pour voir si l'erreur est due à l'impossibilité de créer une image Docker. Vous devrez peut-être libérer de l'espace disque dans votre environnement.

   Pour de plus amples informations, veuillez consulter Erreur lors de l'exécution SAM des applications localement dans le AWS Toolkit car l' AWS Cloud9 environnement ne dispose pas de suffisamment d'espace disque.

   Lorsque les sessions de débogage démarrent, le DEBUGCONSOLEpanneau affiche les résultats de débogage et affiche toutes les valeurs renvoyées par la fonction Lambda. Lors du débogage SAM d'applications, le AWS Toolkit est sélectionné comme canal de sortie dans le panneau de sortie.

   Note

   Pour les utilisateurs Windows, si une erreur de montage Docker se produit au cours de ce processus, vous devez actualiser les informations d'identification de vos lecteurs partagés dans Docker Settings (Paramètres Docker). Une erreur de montage Docker peut se présenter comme suit.

   Fetching lambci/lambda:nodejs10.x Docker container image......
   2019-07-12 13:36:58 Mounting C:\Users\<username>\AppData\Local\Temp\ ... as /var/task:ro,delegated inside runtime container
   Traceback (most recent call last):
   ...requests.exceptions.HTTPError: 500 Server Error: Internal Server Error ...

Pour exécuter et déboguer une application sans serveur directement à partir du code de l'application

1. Pour afficher les fichiers de votre application sans serveur, accédez au dossier de l'application en choisissant l'icône de dossier à côté de l'éditeur.

2. Dans le dossier de l'application (par exemple, my-sample-app), développez le dossier des fonctions (dans cet exemple, hello-world) et ouvrez le app.js fichier.

3. Dans l'action en ligne qui identifie une fonction de gestionnaire Lambda éligible, sélectionnez Add Debug Configuration. Si l'option de configuration add debug (ajouter le débogage) n'apparaît pas, vous devez activer les lentilles de code. Pour activer les lentilles de code, consultez Activer les lentilles de code du AWS Toolkit .

   

4. Sélectionnez le moteur d'exécution sur lequel votre SAM application s'exécute.

5. Dans l'éditeur du fichier launch.json, modifiez ou confirmez les valeurs des propriétés de configuration suivantes :

   • "name" – Saisissez un nom convivial pour le lecteur.

   • "target" – Vérifiez que la valeur est "code" afin qu'un gestionnaire de fonction Lambda soit directement appelé.

   • "lambdaHandler" – Saisissez le nom de la méthode dans votre code que Lambda appelle pour exécuter votre fonction. Par exemple, pour les applications dans JavaScript, la valeur par défaut estapp.lambdaHandler.

   • "projectRoot" – Saisissez le chemin du fichier d'application qui contient la fonction Lambda.

   • "runtime" : saisissez ou confirmez un environnement d'exécution valide pour l'environnement d'exécution Lambda (par exemple, "nodejs.12x").

   • "payload" – Choisissez l'une des options suivantes pour définir la charge utile d'événement à fournir à votre fonction Lambda comme entrée :

     • "json": paires JSON clé-valeur formatées qui définissent la charge utile de l'événement.

     • "path" : chemin du fichier utilisé comme charge utile d'événement.

6. Si vous êtes satisfait de la configuration de débogage, cliquez sur la flèche verte à côté RUNpour démarrer le débogage.

   Lorsque les sessions de débogage démarrent, le DEBUGCONSOLEpanneau affiche les résultats de débogage et affiche toutes les valeurs renvoyées par la fonction Lambda. Lors du débogage SAM d'applications, AWS Toolkit est sélectionné comme canal de sortie dans le panneau de sortie.

   Note

   Si Docker est mentionné dans les messages d'erreur, consultez cette note.

Pour exécuter et déboguer les ressources de API passerelle locales

1. Choisissez l'une des approches suivantes pour créer une configuration de lancement pour une ressource de AWS SAM API passerelle :

   • Option 1 : consultez le code source du gestionnaire (plus précisément, un fichier .js, .cs ou .py) dans votre projet AWS SAM , passez la souris sur le gestionnaire Lambda et choisissez Add Debug Configuration (Ajouter une configuration de débogage). Si l'option n'apparaît pas, activez les lentilles de code. Pour activer les lentilles de code, consultez Activer les lentilles de code du AWS Toolkit .). Ensuite, dans le menu, choisissez l'élément marqué API Événement.

   • Option 2 Modifiez launch.json et créez une configuration de lancement à l'aide de la commande suivante.

     {
         "type": "aws-sam",
         "request": "direct-invoke",
         "name": "myConfig",
         "invokeTarget": {
             "target": "api",
             "templatePath": "n12/template.yaml",
             "logicalId": "HelloWorldFunction"
         },
         "api": {
             "path": "/hello",
             "httpMethod": "post",
             "payload": {
                 "json": {}
             }
         }, 
         "sam": {},
         "aws": {}
     }
                             

2. Dans le menu déroulant en regard du bouton Run (Exécuter), choisissez la configuration de lancement (appelée myConfig dans l'exemple précédent).

3. (Facultatif) Ajoutez des points d'arrêt à votre code de projet Lambda.

4. Cliquez sur le bouton Exécuter en regard du bouton vert « exécuter ».

5. Consultez les résultats dans le volet de sortie.

1. Dans la fenêtre de l'AWS explorateur, ouvrez le menu contextuel (clic droit) du nœud Lambda et sélectionnez Sync SAM Application.

2. Choisissez le Région AWS vers lequel déployer.

3. Choisissez le fichier template.yaml à utiliser pour le déploiement.

4. Saisissez le nom d'un compartiment Amazon S3 que ce déploiement peut utiliser. Le compartiment doit se trouver dans la région dans laquelle vous effectuez le déploiement.

   Avertissement

   Le nom de compartiment S3 doit être unique parmi tous les noms de compartiment existants dans Amazon S3. Ajoutez un identifiant unique au nom donné dans l'exemple suivant ou choisissez un autre nom.

5. Si votre application sans serveur inclut une fonction avec un type de packageImage, entrez le nom d'un ECR référentiel Amazon que ce déploiement peut utiliser. Le compartiment doit se trouver dans la région dans laquelle vous effectuez le déploiement.

6. Saisissez un nom pour la pile déployée : soit un nouveau nom de pile, soit un nom de pile existant.

7. Vérifiez le succès du déploiement dans l'onglet Boîte à outils AWS de la console.

   Si une erreur se produit, un message contextuel apparaît dans la partie inférieure droite.

   Dans ce cas, vérifiez le texte dans l'onglet Boîte à outils AWS pour plus de détails. Voici un exemple de détails d'erreur.

   Error with child process: Unable to upload artifact HelloWorldFunction referenced by CodeUri parameter of HelloWorldFunction resource.
   S3 Bucket does not exist. Execute the command to create a new bucket
   aws s3 mb s3://pbart-my-sam-app-bucket
   An error occurred while deploying a SAM Application. Check the logs for more information by running the "View AWS Toolkit Logs" command from the Command Palette.

   Dans cet exemple, l'erreur s'est produite, car le compartiment Amazon S3 n'existait pas.