View a markdown version of this page

Edificio Node.js Funzioni di eventi Lambda con esbuild in AWS SAM - AWS Serverless Application Model

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Edificio Node.js Funzioni di eventi Lambda con esbuild in AWS SAM

Compilare e impacchettare Node.js AWS Lambda Event Functions, puoi usare AWS SAM CLI con l'esbuild JavaScript bundler. Il bundler esbuild supporta le funzioni Lambda in cui scrivi TypeScript.

Costruire un Node.js Funzione Lambda con esbuild, aggiungi un Metadata oggetto al tuo AWS:Serverless::Function risorsa e specifica esbuild per BuildMethod. Quando esegui il sam build comando, AWS SAM usa esbuild per raggruppare il codice della funzione Lambda.

Puoi anche raggruppare un AWS::Serverless::WebFunction con esbuild. È EntryPoint il file è il punto di ingresso e i punti del modello creato EntryPoint nel file in bundle. Per ulteriori informazioni, consulta Creazione e distribuzione di Lambda Web Functions.

Proprietà dei metadati

Le Metadata object supporta le seguenti proprietà per esbuild.

BuildMethod

Specifica il bundler per l'applicazione. L’unico valore supportato è esbuild.

BuildProperties

Specifica le proprietà di compilazione per il codice della funzione Lambda.

Il BuildProperties object supporta le seguenti proprietà per esbuild. Tutte le proprietà sono opzionali. Per impostazione predefinita, AWS SAM utilizza il gestore di funzioni Lambda per il punto di ingresso.

EntryPoints

Specifica i punti di ingresso per l'applicazione.

Esterno

Specifica l'elenco dei pacchetti da omettere dalla build. Per ulteriori informazioni, vedere Esterno nel esbuild sito.

Formato

Specifica il formato di output del generato JavaScript file nell'applicazione. Per ulteriori informazioni, vedere Formato nel sito web esbuild.

Loader

Specifica l'elenco delle configurazioni per il caricamento dei dati per un determinato tipo di file.

MainFields

Specifica quali package.json campi da provare a importare durante la risoluzione di un pacchetto. Il valore predefinito è main,module.

Minimizza

Specifica se minimizzare il codice di output in bundle. Il valore predefinito è true.

OutExtension

Personalizza l'estensione dei file generati da esbuild. Per ulteriori informazioni, vedere Estensione Out nel sito web esbuild.

Mappa di origine

Specifica se il bundler produce un file di mappa sorgente. Il valore predefinito è false.

Quando è impostato su true, NODE_OPTIONS: --enable-source-maps viene aggiunto alle variabili di ambiente della funzione Lambda e una mappa di origine viene generata e inclusa nella funzione.

In alternativa, quando NODE_OPTIONS: --enable-source-maps è incluso nelle variabili di ambiente della funzione, Sourcemap è impostato automaticamente su true.

In caso di conflitto, Sourcemap: false ha la precedenza su NODE_OPTIONS: --enable-source-maps.

Nota

Per impostazione predefinita, Lambda crittografa tutte le variabili di ambiente inattive con AWS Key Management Service (AWS KMS). Quando si utilizzano le mappe di origine, affinché la distribuzione abbia esito positivo, il ruolo di esecuzione della funzione deve disporre dell'autorizzazione per eseguire kms:Encrypt azione.

SourcesContent

Specifica se includere il codice sorgente nel file di mappa sorgente. Configura questa proprietà quando Sourcemap è impostato su 'true'.

  • Specificare SourcesContent: 'true' per includere tutto il codice sorgente.

  • Specificare SourcesContent: 'false' per escludere tutto il codice sorgente. Ciò si traduce in file di mappe sorgente di dimensioni inferiori, utili in produzione riducendo i tempi di avvio. Tuttavia, il codice sorgente non sarà disponibile nel debugger.

Il valore predefinito è SourcesContent: true.

Per ulteriori informazioni, vedere Fonti e contenuti nel sito web esbuild.

Target

Specifica la versione ECMAScript di destinazione. Il valore predefinito è es2020.

TypeScript Esempio di funzione Lambda Event

L'esempio seguente AWS SAM lo snippet di modello utilizza esbuild per creare un Node.js funzione Lambda da TypeScript codice in 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>"