Déployez le code TypeScript transpilé dans Lambda à l’aide d’archives de fichiers .zip

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

sam init --app-template hello-world-typescript --name sam-app --package-type Zip --runtime nodejs22.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 pour accepter les options par défaut fournies dans l’expérience interactive Enter.

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 pack @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 le composant NodeJsFunction, qui crée la fonction Lambda, et le composant LambdaRestApi, 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 de plus amples informations, veuillez consulter Configuration d’esbuild dans les références de l’API du AWS CDK.

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

Le AWS CDK crée et conditionne la fonction Lambda à l’aide d’esbuild, puis la déploie 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 projet Node.js avec npm ou un gestionnaire de packs de votre choix.

npm init

Ajoutez les packs @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 "nodejs22.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\"}"
}