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.
Bâtiment Node.js Fonctions événementielles Lambda avec esbuild AWS SAM
Pour créer et empaqueter Node.js AWS Lambda Fonctions événementielles, vous pouvez utiliser AWS SAM CLI avec l'esbuild JavaScript groupeur. Le bundler esbuild prend en charge les fonctions Lambda que vous écrivez dans TypeScript.
Pour construire un Node.js Fonction Lambda avec esbuild, ajoutez un Metadata objectez à votre AWS:Serverless::Function ressourcer et spécifier esbuild pour le BuildMethod. Lorsque vous exécutez sam build commande, AWS SAM utilise esbuild pour regrouper le code de votre fonction Lambda.
Vous pouvez également regrouper un AWS::Serverless::WebFunction avec esbuild. C'est EntryPoint le fichier est le point d'entrée et le modèle construit pointe EntryPoint dans le fichier groupé. Pour plus d’informations, consultez Création et déploiement de fonctions Web Lambda.
Propriétés de métadonnées
L'objet Metadata prend en charge les propriétés suivantes pour esbuild.
BuildMethod
Spécifie le bundler de votre application. La seule valeur prise en charge est esbuild.
BuildProperties
Spécifie les propriétés de création du code de votre fonction Lambda.
L'objet BuildProperties prend en charge les propriétés suivantes pour esbuild. Toutes les propriétés sont facultatives. Par défaut, AWS SAM utilise votre gestionnaire de fonctions Lambda pour le point d'entrée.
- EntryPoints
-
Spécifie les points d'entrée de votre application.
- Externe
-
Spécifie la liste des packages à omettre de la création. Pour plus d'informations, veuillez consulter la section Externe
sur le site Web esbuild (langue française non garantie). - Format
-
Spécifie le format de sortie du JavaScript fichiers de votre application. Pour plus d'informations, consultez la section Format
du site Web esbuild. - Chargeur
-
Spécifie la liste des configurations de chargement des données pour un type de fichier donné.
- MainFields
-
Spécifie les champs
package.jsonà essayer d'importer lors de la résolution d'un package. La valeur par défaut estmain,module. - Réduire
-
Spécifie s'il faut réduire le code de sortie groupé. La valeur par défaut est
true. - OutExtension
-
Personnalisez l'extension des fichiers générés par esbuild. Pour plus d'informations, veuillez consulter Out extension
sur le site Web esbuild. - Carte source
-
Spécifie si le bundler produit un fichier de carte source. La valeur par défaut est
false.Lorsqu'il a la valeur
true,NODE_OPTIONS: --enable-source-mapsest ajouté aux variables d'environnement de la fonction Lambda, et une carte source est générée et incluse dans la fonction.Sinon, lorsque
NODE_OPTIONS: --enable-source-mapsest inclus dans les variables d'environnement de la fonction,Sourcemapest automatiquement défini surtrue.En cas de conflit,
Sourcemap: falsea la priorité surNODE_OPTIONS: --enable-source-maps.NotePar défaut, Lambda chiffre toutes les variables d'environnement au repos avec AWS Key Management Service (AWS KMS). Lorsque vous utilisez des cartes sources, pour que le déploiement réussisse, le rôle d'exécution de votre fonction doit avoir l'autorisation d'effectuer l'action
kms:Encrypt. - SourcesContent
-
Indique s'il faut inclure votre code source dans votre fichier de carte source. Configurez cette propriété lorsque
Sourcemapest définie sur'true'.-
Spécifiez
SourcesContent: 'true'pour inclure tout le code source. -
Spécifiez
SourcesContent: 'false'pour exclure tout le code source. Cela permet de réduire la taille des fichiers de cartes sources, ce qui est utile en production en réduisant les temps de démarrage. Cependant, le code source ne sera pas disponible dans le débogueur.
La valeur par défaut est
SourcesContent: true.Pour plus d'informations, consultez la section Contenu des sources
du site web esbuild. -
- Cible
-
Spécifie la version d'ECMAScript cible. La valeur par défaut est
es2020.
TypeScript Exemple de fonction événementielle Lambda
L'exemple suivant AWS SAM l'extrait de modèle utilise esbuild pour créer un Node.js Fonction Lambda de TypeScript code dans hello-world/app.ts.
Resources: HelloWorldFunction: Type: AWS::Serverless::Function Properties: CodeUri: hello-world/ Handler: app.handler Runtime: nodejs20.x Architectures: - x86_64 Events: HelloWorld: Type: Api Properties: Path: /hello Method: get Environment: Variables: NODE_OPTIONS: --enable-source-maps Metadata: BuildMethod: esbuild BuildProperties: Format: esm Minify: false OutExtension: - .js=.mjs Target: "es2020" Sourcemap: true EntryPoints: - app.ts External: - "<package-to-exclude>"