{"id":94,"date":"2017-08-24T17:27:59","date_gmt":"2017-08-24T11:57:59","guid":{"rendered":"https:\/\/www.ecomm.in\/blog\/?p=94"},"modified":"2017-08-25T23:33:27","modified_gmt":"2017-08-25T18:03:27","slug":"less-server-more-serverless-creating-your-first-aws-lambda-function","status":"publish","type":"post","link":"https:\/\/www.ecomm.in\/blog\/less-server-more-serverless-creating-your-first-aws-lambda-function\/","title":{"rendered":"Serverless Future: Creating your first AWS Lambda function"},"content":{"rendered":"

Howdy techies! I’m Tanmay with the DevOps team at Ecomm India Cloud IT which helps companies with cloud transformation<\/a> and DevOps processes on top of cloud Platforms like AWS. Part of what I do everyday is help organizations drastically increase their pace of innovation by removing bottlenecks with DevOps pipelines that increase their performance efficiency and reduce cost.<\/p>\n

I have been working on few exciting projects in the recent months involving Rest API\u2019s and Serverless architecture. I thought I would share with you some of the serverless tools and techniques that i have learnt which might help you with your future projects.<\/p>\n

So, in this article I will be showing you how to create a serverless function and a rest api to trigger this serverless function. For this I will be using Amazon Web Services Lambda and API Gateway<\/a>. I will be creating a basic Even Odd Function using python environment, where the function will determine whether the user input is even or odd. I am selecting a very basic function, so that anybody can use this article to start learning Lambda function and API gateway without needing too much coding experience. However, it is recommended that the user should know basics of AWS. If you are new to cloud computing and want to make a career in it, I recommend you to visit AWS training<\/a> section on our website for more hands-on training on AWS.<\/p>\n

So, what is serverless computing?<\/h2>\n

About a decade ago or physical servers were still in demand, thanks to cloud servers that is no longer the case, technically the physical servers still do exist it\u2019s just that you don\u2019t need to manage them as they are either automated or managed by a service provider at a very low cost. And now serverless is abstracting cloud servers.<\/p>\n

Serverless architecture is defined by stateless compute containers and modeled for an event-driven solution. AWS Lambda is the perfect example of serverless architecture and employs Functions as a service (FaaS)<\/strong> model of cloud computing. Platform as a Service (PaaS) architectures popularized by Salesforce Heroku, AWS Elastic Beanstalk and Microsoft Azure simplify applications deployment for developers. And serverless architecture or FaaS is the next step in that direction.<\/strong><\/p>\n

Advantage of going serverless<\/h2>\n

Main advantage is that you no longer need to keep a cloud server \/ instance running all the time. The serverless compute capacity appears when you need it, then disappears when you\u2019re done with it just like a function and all your business logic can now live within these functions.<\/p>\n

So, what can you do with Lambda Functions?<\/h2>\n

You can do a simple echo function, to a fully operational automated chatbot for your website, possibilities are endless.<\/p>\n

Before we get our hands dirty here are few things that you require to create your first lambda function:<\/p>\n

    \n
  1. First, you\u2019ll need an AWS account. If you don\u2019t have one yet, start by opening a free AWS account here<\/a>. AWS has a free tier that\u2019s more than enough for what you will need for this tutorial.<\/li>\n
  2. Basic understanding of programming environment, AWS Lambda currently supports code written in js<\/strong> (JavaScript<\/strong>), Python, Java<\/strong> (Java 8<\/strong> compatible), and C# (.NET Core). Your code can include existing libraries, even native ones. Please read AWS documentation on using Node.js<\/strong>, Python, Java<\/strong>, and C#.<\/li>\n<\/ol>\n

    Once you are done with setting up your AWS Account we can move on to creating our even odd function in python 2.7 environment using AWS Lambda and API gateway.<\/p>\n

    Getting Started<\/h2>\n

    Right, now that we have the basic things in order, we can dig in! To get started, login to your AWS Management console<\/a>, once done you should see a screen like below:<\/p>\n

    \"\"<\/p>\n

    Make a note of the region you are working in, as all your resources will be created in this region. I\u2019m using \u201cUS-East-2\u201d region that is \u201cOhio\u201d. Click here or more information on regions and availability zones.<\/a><\/p>\n

    AWS Lambda Function<\/h2>\n

    To start with the coding click on the Lambda link present under Compute section or just write in the text bar provided below AWS Services title. For this post, I am creating a function which will check whether the given number is even or odd.<\/p>\n

    You should see below page if you have never used AWS Lambda before, from here you can quickly access documentation related to Lambda, find out its cost or could learn new features. Take your time to go through these details before proceeding to create a function.<\/p>\n

    \"\"<\/p>\n

    Blueprint<\/h3>\n

    Once you are ready click on the create a function on the top right corner of this page.<\/p>\n

    \"\"<\/p>\n

    You can see some sample blueprints on this screen to start off with or can start from scratch, for this blog I will start from scratch.<\/p>\n

    After you click author from scratch you should get below screen.<\/p>\n

    Triggers<\/h3>\n

    \"\"<\/p>\n

    Here you can configure the triggers which will call this Lambda function and give you the result depending on the code, you can choose from a few options. \u00a0I will be using API Gateway as the trigger method, this way we can test the Lambda function from our browser. So, update the values as shown below. Please note for simplicity reasons I am keeping the security open, it is recommended that you use either AWS IAM or Access ID & Code for securing your API from other users. That is advanced method and we shall cover that later. Once you are done with making changes to your screen click next.<\/p>\n

    \"\"<\/p>\n

    Configure Function<\/h3>\n

    After this click next, you should get below screen.<\/p>\n

    \"\"<\/p>\n

    Change the runtime environment from Node.js 6.10 to Python 2.7 as I am providing the code in python language. Make sure you give an appropriate Name to the function and an optional description. \u00a0I have updated the Name and Description of the function to indicate its purpose.<\/p>\n

    \"\"<\/p>\n

    Once you are done, scroll down to start with your code.<\/p>\n

    Code<\/h3>\n

    \"\"<\/p>\n

    def lambda_handler(event, context):\r\n\r\n\u00a0\u00a0\u00a0 #We are accepting a number from the user and storing it in variable num.\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 num = event['number']\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 #The % operator is the modulo, which returns the remainder rather than the quotient after division.\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 res = num % 2\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if res == 0:\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 #Check whether the remainder is 0 if so set the return message to even.\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ret = \"%d Number is an even number!\" %(num)\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 else:\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 #set the return message to odd.\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ret = \"%d Number is an odd number!\" %(num)\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 return ret<\/pre>\n
    <\/h3>\n
    Handler & Permissions<\/h3>\n
    Once you are done writing the code make sure you set the handler name with function.lambda_handler where function is the name of your function, for me its evenodd hence my handler is evenodd.lambda_handler. Next step is to create a role to allow this lambda to execute the function, select an appropriate name for the role and attach policy template by typing lambda inside the dropdown box indicated by the arrow, you should select \u201cBasic Edge Lambda Permissions\u201d<\/p>\n
    \"\"<\/p>\n
    Scroll down and click on advanced settings and edit the time out from 3 seconds to 30 seconds.<\/p>\n
    \"\"<\/p>\n
    Leave all other things to default. After that click, next and you should see below screen:<\/p>\n
    \"\"<\/p>\n
    Finally click on the create function button.<\/p>\n
    Testing<\/h3>\n
    Next step is to click on Test button, edit the test document as shown below:<\/p>\n
    \"\"<\/p>\n
    And click save and test. You should see a window similar to below window:<\/p>\n
    \"\"<\/p>\n
    If you get execution result as succeeded then that means our function is working as expected.<\/p>\n
    We have tested the function from within the lambda function for complete functionality we have a trigger to invoke this lambda function from outside of the AWS. But first we need to update a few things in our API gateway.<\/p>\n
    API Gateway<\/h2>\n
    Click on API Gateway it is in the Application Services section, or you can write API Gateway in the text bar at the top. Once you open API Gateway you should get below screen:<\/p>\n
    \"\"<\/p>\n
    You can see that the lambda function has already created an API for us as we defined it in the trigger section declaration of lambda function. So, click on this API to get started.<\/p>\n
    Create Methods<\/h3>\n
    Click on the resource (\/evenodd) to see below screen<\/p>\n
    \"\"<\/p>\n
    By default, when you create a trigger of API Gateway from Lambda function it creates the any method for its execution. However, I am going to create a new method to use this API gateway. First, I will create a Get method and later I will create a POST method. To start this process, click on the action button at the top and select create method<\/p>\n
    \"\"<\/p>\n
    GET Method<\/h4>\n
    Select GET Method from the dropdown list.<\/p>\n
    \"\"<\/p>\n
    In here use the integration type as Lambda function and then select the Lambda region that you have used to create your lambda in, for me it was US-EAST-2 (Ohio) so my settings are like:<\/p>\n
    \"\"<\/p>\n
     <\/p>\n
    \"\"<\/p>\n
    Once you are done with updating the details, click next and you\u2019d get a pop up like below.<\/p>\n
    \"\"<\/p>\n
    click ok on this message to get a screen like below.<\/p>\n
    \"\"<\/p>\n
    Now click on the Integration Request link highlighted in the below image:<\/p>\n
    Integration Request<\/h5>\n
    You should get a screen like:<\/p>\n
    \"\"<\/p>\n
    \"\"<\/p>\n
    Now click on the arrow next to \u201cBody Mapping Templates\u201d<\/p>\n
     <\/p>\n
    Body Mapping Templates<\/h5>\n
    \"\"<\/p>\n
    By default, there are no templates defined, so select second option on \u201cRequest Body Passthrough\u201d that is when there are no templates defined (Recommended) option and click on add mapping templates.<\/p>\n
    You should get a box like below:<\/p>\n
    \"\"<\/p>\n
    By default, the content-type suggested is application\/json but it is greyed out so you will need to type it in that box and click on the tick next to it. Once done write in the template section as shown in the below snapshot, and click save. Template field contains:<\/p>\n
    {\"number\" : $input.params('number')}<\/pre>\n
    \"\"<\/p>\n
    Deployment<\/h5>\n
    Once done click on the actions button at the top and select deploy API to get below screen:<\/p>\n
    \"\"<\/p>\n
    You can select a new stage or select an existing stage to overwrite it. I am overwriting the Prod stage, once done click deploy.<\/p>\n
    Once you click deploy you should be redirected to the stages click on the stage to expand it:<\/p>\n
    \"\"<\/p>\n
    Select the method that was created (Get), copy the invoke URL path and add \u201c?number=20\u201d to it and paste it in a new browser window.<\/p>\n
    \"\"<\/p>\n
    https:\/\/n79ttbsqyf.execute-api.us-east-2.amazonaws.com\/prod\/evenodd?number=20<\/a><\/pre>\n
    *** replace above link with your link and use this endpoint. ***<\/p>\n
    \"\"<\/p>\n
    Similarly, you can change the value of the number in the above link and you can check any number.<\/p>\n
    https:\/\/n79ttbsqyf.execute-api.us-east-2.amazonaws.com\/prod\/evenodd?number=11<\/a><\/pre>\n
    *** replace above link with your link and use this endpoint. ***<\/p>\n
    \"\"<\/p>\n
    This way we know that our function can be called using the Get method.<\/p>\n
    POST Method<\/h3>\n
    We can also use the POST method to invoke our function. To create the post method go back to API Gateway Console. Select the API, click on resources and expand the methods. Once you do that you should get below window:<\/p>\n
    \"\"<\/p>\n
    Click on Actions button and select create method and select POST method from the dropdown list. And update the details like we did for the Get method. Once done hit save and you will get a pop like below.<\/p>\n
    \"\"<\/p>\n
     <\/p>\n
    Click ok on this pop up message.<\/p>\n
    \"\"<\/p>\n
    Integration Request<\/h4>\n
    Once you click ok you should get a screen like below:<\/p>\n
    \"\"<\/p>\n
    We will be repeating steps that we did in the Get method.<\/p>\n
    \"\"<\/p>\n
     <\/p>\n
    Body mapping templates<\/h4>\n
    Now click on the Integration Request link that you see. Scroll down after you have clicked till you find Body mapping templates.<\/p>\n
    \"\"<\/p>\n
    By default, there is no body mapping template defined, this template is used to parse the response that you get from Lambda function to a user readable format, without this the API Gateway will not be able to reproduce the response of the lambda function.<\/p>\n
    So, click on the add mapping template and select below options:<\/p>\n
    \"\"<\/p>\n
    By default, the content-type suggested is application\/json but it is greyed out so you will need to type it in that box and click on the tick next to it. Once done write in the template section as shown in the below snapshot, and click save. Template field contains: {“number” : $input.params(‘number’)}<\/p>\n
    \"\"<\/p>\n
    Once done click save.<\/p>\n
    Click on \u201cMethod Execution\u201d button to go back to the POST method page.<\/p>\n
    \"\"<\/p>\n
    Integration Response<\/h4>\n
    Now click on \u201cIntegration Response\u201d link<\/p>\n
    \"\"<\/p>\n
    You should see a screen like below, click on the highlighted arrow.<\/p>\n
    \"\"<\/p>\n
    You should get a screen like below, click on the highlighted part.<\/p>\n
    \"\"<\/p>\n
    And select \u201cConvert to text (if needed)\u201d from the dropdown list and hit save.<\/p>\n
    \"\"<\/p>\n
    Once done click on Actions button, click on Deploy API option.<\/p>\n
    Deployment<\/h4>\n
    Select a new stage and deploy the API.<\/p>\n
    \"\"<\/p>\n
    You can notice the newly created stage in the stages options. Select the newly created stage, select POST method and copy the invoke URL as highlighted below.<\/p>\n
    \"\"<\/p>\n
    Copy the invoke URL that you see and you can use it directly to invoke the Lambda function via this stage and method of the API. Now open your browser paste invoke URL and add \u201c?number=20\u201d and press enter. (Note you can change this number to any integer value.)<\/p>\n
    \u00a0https:\/\/n79ttbsqyf.execute-api.us-east-2.amazonaws.com\/post\/evenodd<\/u>?number=20<\/a><\/pre>\n
    *** replace above link with your link and use this endpoint. ***<\/p>\n
    \"\"<\/p>\n
    Congratulations\u200a- \u200ayou have just set up and deployed your own Lambda Function & API Gateway!<\/p>\n
    Deleting Resources<\/h2>\n
    To delete these resources, follow below screenshots:<\/p>\n
    API Gateway<\/h3>\n
    To delete the API, go back to the API Gateway page and select the API Gateway, then click on the actions button and select \u201cDelete API\u201d option.<\/p>\n
    \"\"<\/p>\n
    Once you click on the Delete API you will get below pop up type the name of the API in the text box and then click delete API, make sure you type correct name otherwise you may delete any other resources.<\/p>\n
    \"\"<\/p>\n
    Lambda Function<\/h3>\n
    Similarly, to delete the Lambda function, go to Lambda console, and select the function to delete it.<\/p>\n
    Click the delete button at the top, below pop up will follow:<\/p>\n
    \"\"<\/p>\n
    Confirm delete by clicking on Delete, this way the function gets deleted.<\/p>\n
    \"\"<\/p>\n
    Congratulations you have successfully completed this simple AWS Lambda Function.<\/p>\n
    If you have any questions related to this post or face any problems, then do comment and I will try to resolve them as quickly as possible.<\/p>\n
    Thanks for reading!<\/p>\n