Thomas TaylorIn November 2023, I wrote a post describing how to deploy a lambda function with a function url in Python. For this post, I want to showcase how streamlined and practical it is to deploy a "Lambdalith" (a single Lambda function) that contains an entire API.
What this means:
- No API Gateway
- API requests can take longer than 30 seconds
- Faster deployments
- Local testing without cloud deployment
- Reduced costs *
- Easy management *
* = Depends on the use-case
How to deploy a serverless API using Fastify
To begin, let's initialize a CDK application for Typescript:
cdk init app --language typescript
This creates the boilerplate directories and files we'll need:
serverless-api
├── README.md
├── bin
│ └── serverless-api.ts
├── cdk.json
├── jest.config.js
├── lib
│ └── serverless-api-stack.ts
├── package-lock.json
├── package.json
├── test
│ └── serverless-api.test.ts
└── tsconfig.json
Install and configure Fastify
Fastify is a JavaScript web framework that intentionally aims for low overhead and speed over other frameworks such as express. I have arbitrarily chose it for this tutorial, but any web framework that supports routing will work.
Install fastify
Install fastify using one of the methods described in their documentation and their AWS Lambda adapter @fastify/aws-lambda.
For this tutorial, I'll use npm.
npm i fastify @fastify/aws-lambda @types/aws-lambda
Create an entry file
To make it easy, we'll create an entry point for the lambda at handler/index.ts with the following contents:
import Fastify from "fastify";
import awsLambdaFastify from "@fastify/aws-lambda";
function init() {
const app = Fastify();
app.get('/', (request, reply) => reply.send({ hello: 'world' }));
return app;
}
if (require.main === module) {
// called directly i.e. "node app"
init().listen({ port: 3000 }, (err) => {
if (err) console.error(err);
console.log('server listening on 3000');
});
} else {
// required as a module => executed on aws lambda
exports.handler = awsLambdaFastify(init())
}
The directory structure should look like the following tree:
serverless-api
├── README.md
├── bin
│ └── serverless-api.ts
├── cdk.json
├── handler
│ └── index.ts
├── jest.config.js
├── lib
│ └── serverless-api-stack.ts
├── package-lock.json
├── package.json
├── test
│ └── serverless-api.test.ts
└── tsconfig.json
With this method, we are able to test locally without deploying to the cloud.
First, transpile the Typescript files to JavaScript:
npm run build
Then execute the handler/index.js file with node:
node handler/index.js
If you visit http://localhost:3000 in your browser, it should display:
{
"hello": "world"
}
Deploying the function with the function url enabled
Fortunately, the AWS CDK enables users to quickly deploy using the NodeJSFunction construct. Replace the contents of serverless-api-stack.ts with the following snippet:
import * as cdk from 'aws-cdk-lib';
import { Construct } from 'constructs';
import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';
import { FunctionUrlAuthType } from 'aws-cdk-lib/aws-lambda';
export class ServerlessApiStack extends cdk.Stack {
constructor(scope: Construct, id: string, props?: cdk.StackProps) {
super(scope, id, props);
const handler = new NodejsFunction(this, 'handler', {
entry: './handler/index.ts',
timeout: cdk.Duration.minutes(1)
});
const url = handler.addFunctionUrl({
authType: FunctionUrlAuthType.NONE
});
new cdk.CfnOutput(this, 'url', {
value: url.url
});
}
}
The code creates a NodejsFunction lambda, enables the function url without authentication, and outputs the url as a CloudFormation export.
Deploy the stack using the cdk:
npx cdk deploy
The command output contains the CfnOutput value:
Do you wish to deploy these changes (y/n)? y
ServerlessApiStack: deploying... [1/1]
ServerlessApiStack: creating CloudFormation changeset...
✅ ServerlessApiStack
✨ Deployment time: 38.19s
Outputs:
ServerlessApiStack.url = https://{id}.lambda-url.us-east-1.on.aws/
Stack ARN:
arn:aws:cloudformation:us-east-1:123456789012:stack/ServerlessApiStack/{id}
If you navigate to the url, you will view the expected results displayed:
{
"hello": "world"
}
All of this was completed with very little infrastructure to manage and a single index.ts file. From here, you can expand the project to include as many routes as you prefer.
