Implementar código de TypeScript transpilado en Lambda con archivos .zip

Inicialice la aplicación utilizando la plantilla de TypeScript de tipo “hola mundo”.

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

(Opcional) La aplicación de ejemplo incluye configuraciones para herramientas de uso habitual, tales como ESLint para linting de código y Jest para pruebas unitarias. Para ejecutar comandos de lint y pruebas:

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

Compile la aplicación.

cd sam-app
sam build

Implemente la aplicación.

sam deploy --guided

Siga las indicaciones que aparecen en pantalla. Para aceptar las opciones predeterminadas proporcionadas en la experiencia interactiva, responda con Enter.

El resultado muestra el punto de conexión de la API REST. Abra el punto de conexión en un navegador para probar la función. Debería ver esta respuesta:

{"message":"hello world"}

Se trata de un punto de conexión de API pública al que se puede acceder a través de Internet. Se recomienda eliminar el punto de conexión después de las pruebas.

sam delete

Cree un directorio de proyecto para la nueva aplicación.

mkdir hello-world
cd hello-world

Inicialice la aplicación.

cdk init app --language typescript

Agregue el paquete @types/aws-lambda en forma de dependencia de desarrollo. Este paquete contiene las definiciones de tipos de Lambda.

npm install -D @types/aws-lambda

Abra el directorio lib. Debería ver un archivo llamado hello-world-stack.ts. Cree dos nuevos archivos en este directorio: hello-world.function.ts y hello-world.ts.

Abra hello-world.function.ts y agregue el siguiente código al archivo. Se trata del código de la función de 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 hello-world.ts y agregue el siguiente código al archivo. Este código contiene la construcción NodejsFunction, que crea la función de Lambda, y la construcción LambdaRestApi, que crea la 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,
    });
  }
}

La construcción NodejsFunction presupone lo siguiente de manera predeterminada:

Puede cambiar este comportamiento y configurar otros parámetros de esbuild. Para obtener más información, consulte Configuración de esbuild en la Referencia de la API de AWS CDK.

Abra hello-world-stack.ts. Este es el código que define la pila de AWS CDK. Reemplace el código con lo siguiente:

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');
  }
}

el directorio hello-world que contiene su archivo cdk.json, implemente su aplicación.

cdk deploy

AWS CDK compila y empaqueta la función de Lambda mediante esbuild y, a continuación, implementa la función en el tiempo de ejecución de Lambda. El resultado muestra el punto de conexión de la API REST. Abra el punto de conexión en un navegador para probar la función. Debería ver esta respuesta:

{"message":"hello world"}

Se trata de un punto de conexión de API pública al que se puede acceder a través de Internet. Se recomienda eliminar el punto de conexión después de las pruebas.

En su máquina local, cree un directorio de proyecto para su nueva función.

Cree un nuevo proyecto de Node.js con npm o un administrador de paquetes de su elección.

npm init

Agregue los paquetes @types/aws-lambda y esbuild en forma de dependencias de desarrollo. El paquete @types/aws-lambda contiene las definiciones de tipos de Lambda.

npm install -D @types/aws-lambda esbuild

Cree un nuevo archivo con el nombre index.ts. Agregue el siguiente código al nuevo archivo. Se trata del código de la función de Lambda. La función devuelve el mensaje hello world. La función no crea ningún recurso de 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',
      }),
   };
};

Agregue un script de compilación al archivo package.json. Esto configura esbuild para que cree automáticamente el paquete de implementación .zip. Para obtener más información, consulte Build scripts (Scripts de compilación) en la documentación de esbuild.

Cree el paquete.

npm run build

Cree una función de Lambda mediante el paquete de implementación .zip. Reemplace el texto resaltado con el nombre de recurso de Amazon (ARN) del rol de ejecución.

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

Ejecute un evento de prueba para confirmar que la función devuelve la siguiente respuesta. Si desea invocar esta función mediante API Gateway, cree y configure una API REST.

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