Hello World Serverless : déployer une fonction AWS Lambda avec CDK + TypeScript

Le serverless est devenu l’une des approches les plus populaires pour construire des applications rapides,scalable et economiques. Avec AWS Lambda, il suffit d’écrire du code : Aws se charge du reste (serveurs,scalabilité…).

Mais un autre outil facilite encore plus l’expérience: AWS CDK, qui permet de décrire votre infrastructure en TypeScript, Java, Python,C# ou Go au lieu d’écrire du YAML ou du Json pour CloudFormation.

Dans cet article je vous montre comment déployer votre toute première fonction aws lambda en quelques minutes grâce à AWS CDK et TypeScript. Aucun préréquis compliqué, pas d’architecture difficile: juste un bon premier pas dans le monde du serverless.

Prérequis

Avant de commencer, il vous faut:

• Node.js
• AWS CLI configurée:

aws configure

• AWS CDK installé:

npm install -g aws-cdk

• Un compte aws actif

1. Initialiser le projet CDK

Creez un dossier pour votre projet:

mkdir cdk-lambda-demo
cd cdk-lambda-demo

Initialisez un projet CDK TypeScript:

cdk init app --language typescript

CDK crée la structure suivante:

/bin    --------------> point d'entrée
/lib    --------------> définition des stacks
cdk.json -------------> configuration CDK
tsconfig.json
package.json

2. Créer la fonction Lambda

Créer un dossier /lambda/ et un ficher hello.ts

mkdir lambda
touch lambda/hello.ts

Ajouter ce code simple dans le fichier hello.ts

//lambda/hello.ts

export const handler = async()=> {
    return {
        statusCode: 200,
        body: JSON.stringify({message: "hello world from aws cdk "});
    }
};

Cette fonction retourne juste un message en Json.

3. Déclarer la fonction Lambda dans CDK

Ouvrez le fichier lib/cdk-lambda-demo-stack.ts et remplacez son contenu par :

import * as cdk from "aws-cdk-lib";
import { Construct } from "constructs";
import * as lambdaNodejs from 'aws-cdk-lib/aws-lambda-nodejs';

export class CdkLambdaDemoStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

     new lambdaNodejs.NodejsFunction(
      this,
      'HelloHandler', { 
      entry: 'lambda/hello.ts', // path to the Lambda function code
      handler: 'handler',
      functionName: 'HelloHandler' // name of the exported handler function
    });
  }
}

En résumé:

• runtime -> environement d’éxecution de la fontion : Nodejs 18
• code -> dossier contenant la fonction
• handler -> fichier + fontion exportée
• functionName -> c’est le nom de la fonction à utiliser pour un appel depuis la cli aws

4. Déployer la Lambda

avant de deployer:

npm install  # pour intaller les dependences du projet
cdk bootstrap
cdk synth   #pour générer le template Cloudformation du projet

cdk deploy # c'est tres évident

5. Tester la fonction

depuis la cli:

aws labda invoke\
-- function-name HelloHandler \
response.json

puis

cat response.json

depuis la console aws :

6. Nettoyer

cdk destroy

Cela supprime la fontion lambda et la stack CDK.