View a markdown version of this page

Edifício Node.js Funções de eventos Lambda com esbuild in AWS SAM - AWS Serverless Application Model

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Edifício Node.js Funções de eventos Lambda com esbuild in AWS SAM

Para construir e empacotar Node.js AWS Lambda Funções de eventos, você pode usar o AWS SAM CLI com o esbuild JavaScript empacotador. O bundler esbuild oferece suporte às funções do Lambda nas quais você escreve TypeScript.

Para construir um Node.js Função lambda com esbuild, adicione um Metadata opor-se ao seu AWS:Serverless::Function recurso e especifique esbuild para o BuildMethod. Quando você executa o sam build comando, AWS SAM usa esbuild para agrupar seu código de função do Lambda.

Você também pode agrupar um AWS::Serverless::WebFunction com esbuild. É EntryPoint arquivo é o ponto de entrada e os pontos do modelo construído EntryPoint no arquivo incluído. Para obter mais informações, consulte Criação e implantação do Lambda Web Functions.

Propriedades de metadados

O objeto Metadata é compatível com as seguintes propriedades para esbuild.

BuildMethod

Especifica o empacotador do aplicativo. O único valor aceito é esbuild.

BuildProperties

Especifica as propriedades de construção do código da função do Lambda.

O objeto BuildProperties é compatível com as seguintes propriedades para esbuild. Todas as propriedades são opcionais. Por padrão, AWS SAM usa seu manipulador de funções do Lambda como ponto de entrada.

EntryPoints

Especifica pontos de entrada para seu aplicativo.

Externo

Especifica a lista de pacotes a serem omitidos da compilação. Para obter mais informações, consulte Externo no site da esbuild.

Formato

Especifica o formato de saída do gerado JavaScript arquivos em seu aplicativo. Para obter mais informações, consulte Formato no site do esbuild.

Carregador

Especifica a lista de configurações para carregar dados de um determinado tipo de arquivo.

MainFields

Especifica quais campos package.json tentar importar ao resolver um pacote. O valor padrão é main,module.

Minimizar

Especifica se o código de saída incluído deve ser minimizado. O valor padrão é true.

OutExtension

Personalize a extensão dos arquivos que o esbuild gera. Para obter mais informações, consulte Extensão de saída no site da esbuild.

Mapa de origem

Especifica se o bundler produz um arquivo de mapa de origem. O valor padrão é false.

Quando definido como true, NODE_OPTIONS: --enable-source-maps é anexado às variáveis de ambiente da função do Lambda e um mapa de origem é gerado e incluído na função.

Como alternativa, quando NODE_OPTIONS: --enable-source-maps é incluído nas variáveis de ambiente da função, Sourcemap é automaticamente definido como true.

Quando conflitante, Sourcemap: false tem precedência sobre NODE_OPTIONS: --enable-source-maps.

nota

Por padrão, o Lambda criptografa todas as variáveis de ambiente em repouso com AWS Key Management Service (AWS KMS). Ao usar mapas de origem, para que a implantação seja bem-sucedida, a função de execução da sua função deve ter permissão para realizar a ação kms:Encrypt.

SourcesContent

Especifica se o código-fonte deve ser incluído no arquivo do mapa de origem. Configure essa propriedade quando Sourcemap estiver definido como 'true'.

  • Especifique SourcesContent: 'true' para incluir todo o código-fonte.

  • Especifique SourcesContent: 'false' para excluir todo o código-fonte. Isso resulta em tamanhos menores de arquivos de mapas de origem, o que é útil na produção ao reduzir os tempos de inicialização. No entanto, o código-fonte não estará disponível no depurador.

O valor padrão é SourcesContent: true.

Para obter mais informações, consulte Conteúdo de fontes no site esbuild.

Destino

Especifica a versão de destino do ECMAScript. O valor padrão é es2020.

TypeScript Exemplo de função de evento Lambda

O exemplo a seguir AWS SAM o trecho de modelo usa esbuild para criar um Node.js Função lambda de TypeScript código em 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>"