Run NestJS Application in Serverless Framework on AWS

In this article, we’re going to learn how we can run a NestJS application as a Lamda function using the Serverless framework on the AWS platform.

NestJS application in Serverless framework on AWS

Hands-on Steps:

Create NestJS application:

npm i -g @nestjs/clinest new nest-sls && cd nest-sls

Install node dependencies for Serverless:

npm install aws-lambda aws-serverless-express express --save

Map NestJS with ExpressJS:

// src/app.tsimport { NestFactory } from '@nestjs/core';
import { ExpressAdapter } from '@nestjs/platform-express';
import { INestApplication } from '@nestjs/common';
import { AppModule } from './app.module';
import { Express } from 'express';
export async function createApp(
expressApp: Express,
): Promise<INestApplication> {
const app = await NestFactory.create(
AppModule,
new ExpressAdapter(expressApp),
);
return app;
}

Convert ExpressJS to AWS Lamda:

// src/serverless.tsimport { Server } from 'http';
import { Context } from 'aws-lambda';
import { createServer, proxy, Response } from 'aws-serverless-express';
import * as express from 'express';
import { createApp } from './app';
let cachedServer: Server;async function bootstrap(): Promise<Server> {
const expressApp = express();
const app = await createApp(expressApp);
await app.init();
return createServer(expressApp);
}
export async function handler(event: any, context: Context): Promise<Response> {
if (!cachedServer) {
const server = await bootstrap();
cachedServer = server;
}
return proxy(cachedServer, event, context, 'PROMISE').promise;
}

Create a configuration file:

// serverless.ymlservice: serverless-nestjsframeworkVersion: '2'useDotenv: trueprovider:
name: aws
runtime: nodejs12.x
stage: ${opt:stage, 'dev'}
region: ${opt:region, 'ap-southeast-1'}
apiGateway:
shouldStartNameWithService: true
environment:
NODE_ENV: ${env:NODE_ENV}
functions:
app:
handler: dist/serverless.handler
events:
- http:
method: any
path: /{any+}

Build and deploy the Serverless application:

npm run build && sls deploy

Serverless Offline:

Install node dependencies:

npm install serverless-offline --save-dev

Update configuration file:

// serverless.yml...plugins:
- serverless-offline
...

Build and run the Serverless application:

npm run build && sls offline start

The Startup

Get smarter at building your thing. Join The Startup’s +792K followers.

Sign up for Top 10 Stories

By The Startup

Get smarter at building your thing. Subscribe to receive The Startup's top 10 most read stories — delivered straight into your inbox, once a week. Take a look.

By signing up, you will create a Medium account if you don’t already have one. Review our Privacy Policy for more information about our privacy practices.

Check your inbox
Medium sent you an email at to complete your subscription.

The Startup

Get smarter at building your thing. Follow to join The Startup’s +8 million monthly readers & +792K followers.

Muhd Mohaiminul Islam

Written by

Senior Engineer, Full Stack @ Carsome Sdn Bhd

The Startup

Get smarter at building your thing. Follow to join The Startup’s +8 million monthly readers & +792K followers.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store