Distribuisci TypeScript codice transpilato in Lambda con archivi di file .zip

Inizializza l'applicazione utilizzando il modello Hello World. TypeScript

sam init --app-template hello-world-typescript --name sam-app --package-type Zip --runtime nodejs24.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 NodejsFunction costrutto, che crea la funzione Lambda, e il LambdaRestApi costrutto, che crea l'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,
    });
  }
}

Il costrutto NodejsFunction presuppone quanto segue per impostazione predefinita:

È possibile modificare questo comportamento e configurare altri parametri esbuild. Per ulteriori informazioni, consulta Configurazione di esbuild nel riferimento 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

Compila e AWS CDK impacchetta la funzione Lambda utilizzando esbuild, quindi distribuisce la funzione nel runtime 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 Node.js progetto con npm o un gestore di pacchetti a tua scelta.

npm init

Aggiungi i pacchetti @ types/aws -lambda ed 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 alcuna risorsa 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 "nodejs24.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\"}"
}