Déployez TypeScript du code transpilé dans Lambda avec des archives de fichiers .zip

Initialisez l'application à l'aide du TypeScript modèle Hello World.

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

(Facultatif) L’exemple d’application inclut des configurations pour les outils couramment utilisés, tels que ESLlint pour la validation de code et de Jest pour les tests unitaires. Pour exécuter des commandes de test et de validation :

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

Créez l’application.

cd sam-app
sam build

Déployez l’application.

sam deploy --guided

Suivez les invites à l’écran. Répondez avec Enter pour accepter les options par défaut fournies dans l’expérience interactive.

La sortie affiche le point de terminaison de l’API REST. Ouvrez le point de terminaison dans un navigateur pour tester la fonction. Vous devriez voir la réponse suivante :

{"message":"hello world"}

Il s’agit d’un point de terminaison d’API public accessible par Internet. Nous vous recommandons de supprimer le point de terminaison après un test.

sam delete

Créez un répertoire de projets pour votre nouvelle application.

mkdir hello-world
cd hello-world

Initialisez l’application.

cdk init app --language typescript

Ajoutez le package @ types/aws -lambda en tant que dépendance de développement. Ce package contient les définitions de type pour Lambda.

npm install -D @types/aws-lambda

Ouvrez le répertoire lib. Vous devriez voir un fichier nommé hello-world-stack.ts. Créez deux nouveaux fichiers dans ce répertoire : hello-world.function.ts et hello-world.ts.

Ouvrez hello-world.function.ts et ajoutez le code suivant au fichier. Il s’agit du code de la fonction 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',
        }),
    };
};

Ouvrez hello-world.ts et ajoutez le code suivant au fichier. Il contient la NodejsFunction construction qui crée la fonction Lambda et la LambdaRestApi construction qui crée 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,
    });
  }
}

Le composant NodejsFunction suppose les éléments suivants par défaut :

Vous pouvez modifier ce comportement et configurer d’autres paramètres esbuild. Pour plus d'informations, consultez la section Configuration d'esbuild dans la référence de l' AWS CDK API.

Ouvrez hello-world stack.ts. C’est le code qui définit votre pile de AWS CDK. Remplacez le code par ce qui suit :

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

à partir du répertoire hello-world contenant votre fichier cdk.json, déployez votre application.

cdk deploy

Il AWS CDK construit et empaquette la fonction Lambda à l'aide de esbuild, puis déploie la fonction dans l'environnement d'exécution Lambda. La sortie affiche le point de terminaison de l’API REST. Ouvrez le point de terminaison dans un navigateur pour tester la fonction. Vous devriez voir la réponse suivante :

{"message":"hello world"}

Il s’agit d’un point de terminaison d’API public accessible par Internet. Nous vous recommandons de supprimer le point de terminaison après un test.

Sur votre machine locale, créez un répertoire de projets pour votre nouvelle fonction.

Créez un nouveau Node.js projet avec npm ou un gestionnaire de packages de votre choix.

npm init

Ajoutez les packages @ types/aws -lambda et esbuild en tant que dépendances de développement. Le package @types/aws-lambda contient les définitions de type pour Lambda.

npm install -D @types/aws-lambda esbuild

Créez un nouveau fichier nommé index.ts. Ajoutez le code suivant au nouveau fichier. Il s’agit du code de la fonction Lambda. La fonction renvoie un message hello world. La fonction ne crée aucune ressource 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',
      }),
   };
};

Ajoutez un script de génération au fichier package.json. Ceci permet de configurer esbuild pour créer automatiquement le pack de déploiement .zip. Pour plus d’informations, consultez Scripts de génération dans la documentation d’esbuild.

Créez le pack.

npm run build

Créez une fonction Lambda à l’aide du pack de déploiement .zip. Remplacez le texte surligné par l’Amazon Resource Name (ARN) de votre rôle d’exécution.

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

Exécutez un événement de test pour confirmer que la fonction renvoie la réponse suivante. Si vous souhaitez invoquez cette fonction à l’aide d’API Gateway, créez et configurez l’API REST.

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