Implantar código TypeScript transcompilado no Lambda com arquivos .zip

Inicialize a aplicação usando o modelo Hello World TypeScript.

sam init --app-template hello-world-typescript --name sam-app --package-type Zip --runtime nodejs18.x

(Opcional) A aplicação de exemplo inclui configurações para ferramentas bastante usadas, como ESLlint para linting de código e Jest para testes unitários. Para executar comandos lint e de teste:

cd sam-app/hello-world
npm install
npm run lint
npm run test

Crie a aplicação.

cd sam-app
sam build

Implante o aplicativo.

sam deploy --guided

Siga as instruções na tela. Para aceitar as opções padrão fornecidas na experiência interativa, responda com Enter.

A saída mostra o endpoint para a API REST. Abra o endpoint em um navegador para testar a função. Você deverá visualizar esta resposta:

{"message":"hello world"}

Este é um endpoint de API pública que é acessado pela Internet. Recomendamos excluir o endpoint após o teste.

sam delete

Crie um diretório de projeto para sua aplicação.

mkdir hello-world
cd hello-world

Inicialize a aplicação.

cdk init app --language typescript

Adicione o pacote @types/aws-lambda como uma dependência de desenvolvimento. Esse pacote contém as definições de tipo para o Lambda.

npm install -D @types/aws-lambda

Abra o diretório lib. Você deverá ver um arquivo chamado hello-world-stack.ts. Crie dois novos arquivos neste diretório: hello-world.function.ts e hello-world.ts.

Abra o hello-world.function.ts e adicione o código a seguir ao arquivo. Este é o código da função Lambda.

import { Context, APIGatewayProxyResult, APIGatewayEvent } from 'aws-lambda';

export const handler = async (event: APIGatewayEvent, context: Context): Promise<APIGatewayProxyResult> => {
    console.log(`Event: ${JSON.stringify(event, null, 2)}`);
    console.log(`Context: ${JSON.stringify(context, null, 2)}`);
    return {
        statusCode: 200,
        body: JSON.stringify({
            message: 'hello world',
        }),
    };
};

Abra o hello-world.ts e adicione o código a seguir ao arquivo. Ele contém o constructo NodejsFunction, que cria a função Lambda, e o constructo LambdaRestApi, que cria a API REST.

import { Construct } from 'constructs';
import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';
import { LambdaRestApi } from 'aws-cdk-lib/aws-apigateway';
  
export class HelloWorld extends Construct {
  constructor(scope: Construct, id: string) {
    super(scope, id);
    const helloFunction = new NodejsFunction(this, 'function');
    new LambdaRestApi(this, 'apigw', {
      handler: helloFunction,
    });
  }
}

O constructo NodejsFunction assume o seguinte, por padrão:

É possível alterar esse comportamento e configurar outros parâmetros do esbuild. Para mais informações, consulte Configuring esbuild (Configurar esbuild) na referência de API do AWS CDK.

Abra o hello-world-stack.ts. Este é o código que define sua pilha do AWS CDK. Substitua o código pelo seguinte:

import { Stack, StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';
import { HelloWorld } from './hello-world';
  
export class HelloWorldStack extends Stack {
  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);
    new HelloWorld(this, 'hello-world');
  }
}

a partir do diretório do hello-world que contém seu arquivo cdk.json, implante sua aplicação.

cdk deploy

O AWS CDK cria e empacota a função Lambda usando esbuild e implanta a função no runtime do Lambda. A saída mostra o endpoint para a API REST. Abra o endpoint em um navegador para testar a função. Você deverá visualizar esta resposta:

{"message":"hello world"}

Este é um endpoint de API pública que é acessado pela Internet. Recomendamos excluir o endpoint após o teste.

Em sua máquina local, crie um diretório de projeto para sua nova função.

Crie um novo projeto Node.js com npm ou um gerenciador de pacotes de sua escolha.

npm init

Adicione pacotes @types/aws-lambda e esbuild como dependência de desenvolvimento. O pacote @types/aws-lambda contém as definições de tipo para o Lambda.

npm install -D @types/aws-lambda esbuild

Crie um novo arquivo chamado index.ts. Adicione o código a seguir ao novo arquivo. Este é o código da função Lambda. A função retorna uma mensagem hello world. A função não cria recursos do API Gateway.

import { Context, APIGatewayProxyResult, APIGatewayEvent } from 'aws-lambda';

export const handler = async (event: APIGatewayEvent, context: Context): Promise<APIGatewayProxyResult> => {
  console.log(`Event: ${JSON.stringify(event, null, 2)}`);
  console.log(`Context: ${JSON.stringify(context, null, 2)}`);
  return {
      statusCode: 200,
      body: JSON.stringify({
          message: 'hello world',
      }),
   };
};

Adicione um script de compilação ao arquivo package.json. Isso configura o esbuild para criar automaticamente o pacote de implantação .zip. Para obter mais informações, consulte Build scripts (Scripts de compilação) na documentação do esbuild.

Construa o pacote.

npm run build

Crie uma função Lambda usando o pacote de implantação .zip. Substitua o texto em destaque pelo nome do recurso da Amazon (ARN) da função de execução.

aws lambda create-function --function-name hello-world --runtime "nodejs18.x" --role arn:aws:iam::123456789012:role/lambda-ex --zip-file "fileb://dist/index.zip" --handler index.handler

Execute um evento de teste para confirmar que a função retorna a resposta a seguir. Para invocar essa função usando o API Gateway, crie e configure uma API REST.

{
  "statusCode": 200,
  "body": "{\"message\":\"hello world\"}"
}