How to use feature flags with AWS Lambda
A step-by-step guide on how to use ConfigCat's feature flags with AWS Lambda
One of the most important technological breakthroughs of the century has been the internet — a digital network that makes the rest of the world feel like our next-door neighbor. Within the realm of the Internet, a recent technology known as cloud computing has paved the way for software developers to rent and manage remote servers in the cloud for hosting their applications. A smaller component of this technology is called Function as a Service, abbreviated as FaaS. FaaS removes the complexity of managing a full-blown backend server, enabling developers to focus solely on writing and executing the necessary functions required to run their applications.
When FaaS and feature flags are combined, you can toggle individual functions or code blocks in those functions on or off without touching its code. Let's take a closer look.
What are feature flags?
A feature flag is a boolean value linked to a feature that enables you to toggle the feature on or off by changing its value. Feature flags can be used with many programming languages and technologies including cloud platforms like AWS Lambda. Today, I'll demonstrate how to use a feature flag to control the response of a Node.js API endpoint in AWS Lambda. Let's get started.
Before we begin, let's review the essential prerequisites you'll need:
Prerequisites
Basic Node.js and AWS knowledge
Using feature flags with AWS Lambda
AWS Lambda is described on AWS's Website as: "Run code without thinking about servers or clusters". This means, rather than setting up a full-blown backend server to handle requests from your app, you can define functions in the language or runtime of your choice to be executed via a trigger (more on this shortly).
To demonstrate how to use feature flags with AWS Lambda I'll use ConfigCat's hosted feature flag service. They offer a free tier account for experimentation, and there's no limit to the number of feature flags you can implement. ConfigCat also provides an extensive list of SDKs for easy integration.
Up and running with AWS Lambda
To make this demo fun, I'll create a music search app that returns a JSON object of songs produced by a specific artist. I'll use "Eminem" for example. To get up and running with AWS Lambda, you'll need to do the following:
Sign up for a Free Tier AWS account
In the console, click the services menu at the top left, select compute > Lambda then create a new function:
- Create a new function with the following details (starting from top to bottom):
Select the first option - Author from scratch
Function name:
myMusicSearchFunction
Runtime:
Node.js 18.x
Architecture:
x86_64
Permissions: - Leave the default option
Then click Create function.
- Add a trigger for executing the function. I've selected an API Gateway trigger. As a result, when a GET request is sent to the function endpoint it will trigger the execution of the function.
If all went correctly you should be able to see the following response by sending a GET request to the endpoint generated by the trigger:
Response:
"Hello from Lambda!"
Coding the sample app
Let's change the default code to create a simple music search endpoint that returns a list of songs produced by Eminem.
If you prefer to follow along, I've included a sample Node.js app here. Feel free to clone it to your computer.
Setting up the sample app
Because my function will be executed in a node runtime environment, I've included ConfigCat's Node SDK as a dependency. With this SDK, the app will be able to access my ConfigCat dashboard and probe the feature flag value. I'll use the node-fetch
package to fetch the list of songs. The package.json
contains everything the app needs:
Contents of package.json
:
{
"name": "feature-flags-aws-lambda-sample",
"type": "module",
"version": "1.0.0",
"description": "A companion repo for How to use feature flags with AWS Lambda",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "Chavez Harris",
"license": "ISC",
"dependencies": {
"configcat-node": "^9.1.1",
"node-fetch": "^3.3.1"
}
}
Run
npm install
to install the packages.Open the
index.mjs
file. At the top, import the ConfigCat node and fetch package, then create the ConfigCat client using your SDK key (More on this in the next section):
import * as configcat from "configcat-node";
import fetch from "node-fetch";
let configCatClient = configcat.getClient(
"YOUR-CONFIGCAT-SDK-KEY"
);
- Below the above code block, I'll create a handler function to be executed with the following code in the body:
export const handler = async(event) => {
// Query the value of the feature flag and assign it to a constant
const isSearchByArtisteEnabled = await configCatClient.getValueAsync(
"searchbyartiste",
false
);
let response_message = "";
// If the feature flag is enabled
if (isSearchByArtisteEnabled) {
// Fetch a list of songs by eminem
const myData = await fetch(`https://api.deezer.com/search?q=eminem`);
const myDataAsJson = await myData.json();
response_message = myDataAsJson;
} else {
// If the feature flag is disabled
response_message = "Sorry, this feature is not available";
}
// Construct and return a response
const response = {
statusCode: 200,
body: JSON.stringify(response_message),
};
return response;
};
Using a feature flag, I will control how the API responds. When the feature flag is on, it will return the list of songs by Eminem and when it is off the response will be "Sorry, this feature is not available". To do this, I'll use ConfigCat's feature flag service.
Integrating with ConfigCat
First, you'll need to sign up for a free account.
In your dashboard, create a feature flag with the following details.
Ensure that you update the code in index.mjs
with your ConfigCat SDK key and feature key.
Uploading the code to AWS
To update the code of the AWS Lambda function with the code I wrote, I'll zip all the files, including the node_modules
folder, and upload it to AWS.
- In the root folder, run the following command to zip all the files:
zip function.zip *
This will create a function.zip
file.
- On the function page, with the code tab selected, upload your
function.zip
file
- Deploy the function.
By visiting the API endpoint in your browser, you should get the following response:
Did it work?
Head over to the ConfigCat dashboard and turn off the feature flag.
Refresh the page, and you should see:
Congrats! You did it!
Conclusion
The flexibility of feature flags lends itself to many technologies and we've explored how to use them in AWS Lambda without any difficulties. Combining feature flags with cloud functions can unlock a world of many possibilities because you can extend your cloud functions' capabilities. ConfigCat makes it easy to integrate feature flags in many languages and frameworks.
In addition to adding feature flags, you can set up user targeting rules for releasing features to specific user groups. This is most useful when setting up and doing A/B testing. With an account, you get a generous free tier for low-volume use cases which is ideal for getting started with feature flags.
Stay connected
For more posts and other announcements, follow ConfigCat on Twitter, Facebook, LinkedIn, and GitHub. The most lovable feature flag service ever.