Création d'une fonction Web Lambda

Pour créer une fonction Web et un point de terminaison (console)

1. Ouvrez la console Lambda à l'adresse. https://console.aws.amazon.com/lambda/

2. Dans le volet de navigation, sélectionnez Web Functions.

3. Choisissez Create Web Function.

4. Sous Basic information (Informations de base), procédez comme suit :

   1. Dans Nom de la fonction, entrez le nom de votre fonction Web.

   2. Pour Runtime, conservez le runtime par défaut.

   3. Pour le code source, conservez le modèle Hello World pour commencer à partir d'un exemple d'application préconfiguré. Pour déployer votre propre code à la place, choisissez Upload ZIP file ou Amazon S3.

5. Sous Configuration du point de terminaison, procédez comme suit :

   1. Dans Nom du point de terminaison, entrez un nom pour le point de terminaison.

   2. Pour Type, conservez Home-Region. Un Home-Region point de terminaison s'exécute dans une seule région, ce qui en fait la configuration la plus simple pour votre première fonction Web. Pour les options multirégionales, voirPoints de terminaison de la fonction Web Lambda.

      Note

      Vous ne pouvez pas modifier le type de point de terminaison après sa création.

   3. Pour Type d'authentification, choisissez Application-managed Authentification. Avec cette option, Lambda transmet toutes les demandes à votre application, afin que celle-ci gère l'authentification. Pour restreindre l'accès, choisissez plutôt l'authentification IAM, qui oblige les appelants à signer les demandes. Les demandes HomeRegion et les PerRegion points de terminaison utilisent AWS Signature Version 4 (SigV4). Les demandes adressées aux MultiRegion points de terminaison utilisent la version de signature 4a (SIGv4a). Pour plus d’informations, consultez Contrôle d'accès aux terminaux Lambda Web Function.

   4. Pour le déploiement automatique, conservez la dernière révision. Avec ce mode, Lambda achemine automatiquement tout le trafic vers chaque nouvelle révision une fois qu'elle est devenue active. Pour un contrôle manuel du trafic avec des pondérations de révision, choisissez Disabled. Pour plus d’informations, consultez Modèles de déploiement.

6. (Facultatif) Développez les configurations supplémentaires pour remplacer les paramètres par défaut. Par défaut, Lambda crée un rôle d'exécution autorisé à télécharger des journaux sur Amazon CloudWatch, et un compartiment Amazon S3 dans votre compte pour stocker votre code. Dans cette section, vous pouvez choisir un rôle IAM existant ou votre propre compartiment Amazon S3, et vous pouvez également configurer le chiffrement avec une clé gérée par le client, la simultanéité maximale par environnement, les variables d'environnement et les balises.

7. Choisissez Create Web Function.

Pour déployer et tester une fonction Web de démarrage

1. Exécutez la commande suivante :

   aws lambda-web deploy --name my-web-app --hello-world

   --hello-worldécrit les fichiers de démarrage dans le répertoire./my-web-app, en créant le répertoire s'il n'existe pas. Le starter contient server.ts un serveur TypeScript HTTP, et package.jsonREADME.md, etAGENTS.md.

2. Lorsque le déploiement est terminé, copiez l'URL du point de terminaison à partir de la sortie. L'URL ressemble à ce qui suit :

   https://bcdfghjklmnpqrst.b7t.lambda-web.us-east-1.on.aws

3. Envoyez une demande à l'URL du point de terminaison que vous avez copié à l'étape précédente. Remplacez endpoint-url par cette URL :

   curl endpoint-url

   Le starter renvoie une réponse similaire à la suivante :

   {"message":"Hello from Lambda Web!","path":"/"}

Pour créer une fonction Web à l'aide des commandes de l'API (AWS CLI)

1. Créez un package de déploiement .zip à partir du répertoire de votre application, avec votre fichier d'entrée à la racine du package. Téléchargez le package dans un compartiment Amazon S3 répondant aux exigences deConditions préalables. Les commandes suivantes créent le package et utilisent le AWS CLI pour le télécharger.

   cd my-app
   zip -r ../my-app.zip .
   aws s3 cp ../my-app.zip s3://amzn-s3-demo-bucket/my-app.zip

2. Utilisez la AWS CLI commande suivante pour créer la fonction Web avec sa première révision et son point de terminaison. DansrevisionConfig, buildConfig indique l'emplacement du code et le temps d'exécution, ainsi serviceConfig que le rôle d'exécution. La endpointConfig propriété définit le point de terminaison.

   aws lambda-web create-web-function \
       --function-name my-web-app \
       --revision-config '{
         "buildConfig": {
           "codeConfig": {
             "s3Object": { "bucket": "amzn-s3-demo-bucket", "key": "my-app.zip" }
           },
           "runtimeConfig": { "runtime": "nodejs24.x" }
         },
         "serviceConfig": {
           "executionRoleArn": "arn:aws:iam::111122223333:role/my-web-app-execution-role"
         }
       }' \
       --endpoint-config '{
         "endpointName": "my-endpoint",
         "endpointType": "HomeRegion",
         "authType": "ApplicationManaged",
         "autoDeploymentMode": "LatestRevision"
       }'

   La propriété autoDeploymentMode est facultative. Si vous l'omettez, la valeur par défaut estDisabled, et le point de terminaison n'achemine pas automatiquement le trafic vers les nouvelles révisions. Notez revisionId la version révisée dans la réponse.

3. Patientez jusqu'à ce que la révision soit terminéeActive. rev-abc12Remplacez-le par l'ID de révision de l'étape précédente.

   aws lambda-web wait web-function-revision-active \
       --function-name my-web-app \
       --revision-id rev-abc12

4. Obtenez les détails du point de terminaison.

   aws lambda-web get-web-function-endpoint \
       --function-name my-web-app \
       --endpoint-name my-endpoint

   Lorsque c'stateest le cas du point de terminaisonActive, envoyez des demandes à sondomainName. La réponse ressemble à l'extrait suivant.

   {
       "endpointName": "my-endpoint",
       "endpointType": "HomeRegion",
       "domainName": "bcdfghjklmnpqrst.b7t.lambda-web.us-east-1.on.aws",
       "authType": "ApplicationManaged",
       "autoDeploymentMode": "LatestRevision",
       "state": "Active",
       "updateStatus": "Successful"
   }

Pour déployer une modification à l'aide des commandes de l'API (AWS CLI)

• Téléchargez un nouveau package et créez une révision. Une révision est un instantané complet, alors transmettez-le dans son intégralité buildConfig et à serviceConfig chaque fois.

  aws s3 cp ../my-app.zip s3://amzn-s3-demo-bucket/my-app.zip
  aws lambda-web create-web-function-revision \
      --function-name my-web-app \
      --build-config '{
        "codeConfig": {
          "s3Object": { "bucket": "amzn-s3-demo-bucket", "key": "my-app.zip" }
        },
        "runtimeConfig": { "runtime": "nodejs24.x" }
      }' \
      --service-config '{
        "executionRoleArn": "arn:aws:iam::111122223333:role/my-web-app-execution-role"
      }'

  Comme le point de terminaison est autoDeploymentMode défini surLatestRevision, il achemine tout le trafic vers la nouvelle révision une fois celle-ci passéeActive. Si vous définissez autoDeploymentMode cette optionDisabled, vous acheminez le trafic avec des update-web-function-endpoint pondérations de révision à la place. Pour plus d’informations, consultez Modèles de déploiement.