DEV Community

Rahul Lokurte
Rahul Lokurte

Posted on

AWS Lambda using CDK

Infrastructure as code has become a go-to process to automatically provision and manage cloud resources. AWS provides two options for infrastructure as code.

  1. AWS CloudFormation
  2. AWS Cloud Development Kit

With CloudFormation, we have to write a lot of YAML templates or JSON files. As AWS adds more services, we have to add more files to CloudFormation. It becomes difficult to work with lots of files. YAML/JSON is based on data serialization and not an actual programming language. The AWS CDK will overcome the limitations of cloud formation by enabling the reuse of code and proper testing.

AWS CDK is a framework that allows developers to use familiar programming languages to define AWS cloud infrastructure and provision it. CDK provides the Constructs cloud component that cover many of the AWS services and features. It helps us to define our application infrastructure at high level.

we will create a Lambda Function and the infrastructure around lambda function using AWS CDK.

Create a new directory on your system.

mkdir cdk-greetapp && cd cdk-greetapp
Enter fullscreen mode Exit fullscreen mode

We will use cdk init to create a new Javascript CDK project:

cdk init --language javascript
Enter fullscreen mode Exit fullscreen mode

The cdk init command creates a number of files and folders inside the cdk-greetapp directory to help us organize the source code for your AWS CDK app.

We can list the stacks in our app by running the below command. It will show CdkGreetappStack.

$ cdk ls
CdkGreetappStack
Enter fullscreen mode Exit fullscreen mode

Let us install AWS lambda construct library.

npm install @aws-cdk/aws-lambda
Enter fullscreen mode Exit fullscreen mode

Edit the file lib/cdk-greetapp-stack.js to create an AWS lambda resource as shown below.

const cdk = require("@aws-cdk/core");
const lambda = require("@aws-cdk/aws-lambda");

class CdkGreetappStack extends cdk.Stack {
  /**
   *
   * @param {cdk.Construct} scope
   * @param {string} id
   * @param {cdk.StackProps=} props
   */
  constructor(scope, id, props) {
    super(scope, id, props);
    // defines an AWS Lambda resource
    const greet = new lambda.Function(this, "GreetHandler", {
      runtime: lambda.Runtime.NODEJS_14_X,
      code: lambda.Code.fromAsset("lambda"),
      handler: "greet.handler",
    });
  }
}

module.exports = { CdkGreetappStack };
Enter fullscreen mode Exit fullscreen mode
  • Lambda Function uses NodeJS 14.x runtime
  • The handler code is loaded from the directory named lambda where we will add the lambda code.
  • The name of the handler function is greet.handler where greet is the name of file and handler is exported function name.

Lets create a directory name lambda in root folder and add a file greet.js.

mkdir lambda
cd lambda
touch greet.js
Enter fullscreen mode Exit fullscreen mode

Add the lambda code to greet.js

exports.handler = async function (event) {
  console.log("request:", JSON.stringify(event, undefined, 2));
  let response = {
    statusCode: 200,
    body: `Hello ${event.path}. Welcome to CDK!`,
  };
  return response;
};
Enter fullscreen mode Exit fullscreen mode

Before deploying the AWS resource, we can take a look on what resources will be getting created by using below command.

cdk diff
Enter fullscreen mode Exit fullscreen mode

resource-created.png

NOTE: If we have multiple profiles set in our system, we need to tell cdk to look into particular profile. This can be done, by adding below key-value in cdk.json which was generated when we created a CDK project.

"profile": "<YOUR_PROFILE_NAME>"
Enter fullscreen mode Exit fullscreen mode

Now, once we are ok with the resources which will be created, we can deploy it using below command

cdk deploy
Enter fullscreen mode Exit fullscreen mode

Let us open the AWS Lambda console

greet-function.png

Select Amazon API Gateway AWS Proxy from the Event template list.

sample-test.png

Click on Test, we can see that, we get the proper response as shown below.

test-pass-lambda.png

Conclusion

we saw how to create a lambda function and also lambda resource by using AWS Cloud Development Kit. We also saw various commands related to CDK for initiating projects, deploying the resources to AWS. The code repository link is here

If you want to do hands-on, I have created a Youtube Video. You can check out here

Top comments (0)