

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](using-sam-cli-deploy.md#deploying-webfunctions).

## Proprietà dei metadati
<a name="serverless-sam-cli-using-build-typescript-metadata"></a>

Le `Metadata` object supporta le seguenti proprietà per esbuild.

### BuildMethod
<a name="serverless-sam-cli-using-build-typescript-metadata-buildmethod"></a>

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

### BuildProperties
<a name="serverless-sam-cli-using-build-typescript-metadata-buildproperties"></a>

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](https://esbuild.github.io/api/#external) nel *esbuild sito*.

**Formato**  
Specifica il formato di output del generato JavaScript file nell'applicazione. Per ulteriori informazioni, vedere [Formato](https://esbuild.github.io/api/#format) 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](https://esbuild.github.io/api/#out-extension) 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`.  
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](https://esbuild.github.io/api/#sources-content) nel *sito web esbuild*.

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

## TypeScript Esempio di funzione Lambda Event
<a name="serverless-sam-cli-using-build-typescript-example"></a>

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>}}"
```