Implementare il codice TypeScript trasformato in Lambda con gli archivi di file .zip

Inizializzare l'applicazione utilizzando il modello Hello World TypeScript.

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

(Facoltativo) L'applicazione di esempio include configurazioni per strumenti di uso comune, ad esempio ESLIint per analisi del codice e Jest per test unitario. Per eseguire i comandi lint e test:

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

Costruisci l'app.

cd sam-app
sam build

Distribuire l'app.

sam deploy --guided

Seguire le istruzioni visualizzate sullo schermo. Per accettare le opzioni predefinite fornite nell'esperienza interattiva, rispondi con Enter.

L'output mostra l'endpoint per la REST API. Apri l'endpoint in un browser per testare la funzione. Dovresti vedere questa risposta:

{"message":"hello world"}

Questo è un endpoint API pubblico accessibile su Internet. È consigliabile eliminare l'endpoint dopo il test.

sam delete

Crea una directory di progetto per la nuova applicazione.

mkdir hello-world
cd hello-world

Inizializza l'app.

cdk init app --language typescript

Aggiungi il pacchetto @types /aws-lambda come dipendenza di sviluppo. Questo pacchetto contiene le definizioni dei tipi per Lambda.

npm install -D @types/aws-lambda

Apri la directory lib. Dovrebbe essere visualizzato un file chiamato hello-world-stack.ts. Crea due nuovi file in questa directory: hello-world.function.ts e hello-world.ts.

Apri hello-world.function.ts e aggiungi il seguente codice al file. Questo è il codice per la funzione 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',
        }),
    };
};

Apri hello-world.ts e aggiungi il seguente codice al file. Contiene il costrutto NodejsFunction, che crea la funzione Lambda e il costrutto LambdaRestApi, che crea la REST API.

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

Il costrutto NodejsFunction presuppone quanto segue per impostazione predefinita:

È possibile modificare questo comportamento e configurare altri parametri esbuild. Per ulteriori informazioni, consulta la sezione relativa alla configurazione di esbuild nella guida di riferimento dell'API AWS CDK.

Apri hello-world-stack.ts. Questo è il codice che definisce lo stack AWS CDK. Sostituisci il codice con il seguente:

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

dalla directory hello-world contenente il file cdk.json, implementa l'applicazione.

cdk deploy

AWS CDK crea e impacchetta la funzione Lambda usando esbuild e quindi implementa la funzione al runtime di Lambda. L'output mostra l'endpoint per la REST API. Apri l'endpoint in un browser per testare la funzione. Dovresti vedere questa risposta:

{"message":"hello world"}

Questo è un endpoint API pubblico accessibile su Internet. È consigliabile eliminare l'endpoint dopo il test.

Sul tuo computer locale, crea una directory di progetto per la nuova funzione.

Crea un nuovo progetto Node.js con npm o un gestore di pacchetti di tua scelta.

npm init

Aggiungi i pacchetti @types/aws-lambda e esbuild come dipendenze di sviluppo. Il pacchetto @types/aws-lambda contiene le definizioni dei tipi per Lambda.

npm install -D @types/aws-lambda esbuild

Crea un nuovo file denominato index.ts. Aggiungi il seguente codice al nuovo file. Questo è il codice per la funzione Lambda. La funzione restituisce un messaggio hello world. La funzione non crea risorse 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',
      }),
   };
};

Aggiungi uno script di compilazione al file package.json. esbuild viene configurato per creare automaticamente il pacchetto di implementazione .zip. Per ulteriori informazioni, consulta la sezione relativa alla compilazione degli script nella documentazione di esbuild.

Creare il pacchetto.

npm run build

Crea una funzione Lambda utilizzando il pacchetto di implementazione .zip. Sostituisci il testo evidenziato con l'Amazon Resource Name (ARN) del tuo ruolo di esecuzione.

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

Esegui un evento di test per confermare che la funzione restituisca la risposta seguente. Se desideri richiamare questa funzione utilizzando API Gateway, crea e configura una REST API.

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