Deploy Fullstack FastAPI Application On Render For Free in 10 minutes.

Bola Olatunji — Mon, 06 May 2024 13:06:53 +0000

Introduction:

Render is a Platform As A Service which helps developers eliminate the complexities of deployment and allows more focus on building good applications.

FastAPI is a python web framework specifically known for its speed and automatic API documentation. Other awesome features include easy dependency injection and data validation thanks to Pydantic.

That being said, lets get right to deployment!

Link to deployed app: https://swish-taskapp.onrender.com

Deployment Process

Log into render.com and navigate to dashboard and if you are new to render, create an account with your github profile.
Return to dashboard after sign in and select "New Web Service"
Next is to select how you wish to build the web service and you can select "Build and deploy from github repository" and click next.
Connect your repository.
You can decide to grant access to the entire repository or just the one you wish to deploy. In my case, I selected on the repository I wished to deploy and click install at the bottom of the page.
Once all authentication is complete you click connect and move to the deployment settings.
Now, you get to configure the deployment and this is pretty straight forward as shown below.
Further deployment setting are shown below and are project dependent mostly. My app runs on uvicorn hence the commands are as follows:
Next is to select free plan. Which is low performance but great for regular projects that don't require heavy functionality.
Click create and voila, your service will begin deployment!

Runtime Code:

pip install -r requirements.txt

uvicorn main:app --host 0.0.0.0 --port 10000

Deployment log

You can view the progress of your deployment in the logs as shown below. While deploying you get to see the success of your deployment.

After successful deployment, your service will be live and accessible at the url. The live service indication is also shown in the log terminal.

Congratulations!! You have successfully deployed your web
service for free on render in a few minutes!

Build a quick serverless email collector API using AWS API Gateway, AWS Lambda & AWS DynamoDB.

Bola Olatunji — Thu, 14 Mar 2024 11:44:54 +0000

Introduction

AWS is such an incredible service which allows us to perform quite a number of important technical tasks ranging from building databases, to machine learning, expandable object storage and so many others.

In this mini project, I make use of 3 remarkable AWS services to build a simple API to input user email to a database via a click.

Out of project scope: Building a front end button to make use of the API. However, testing will be done using postman.

Prerequisites

AWS account (free tier for new users).
Basic python knowledge

Project Architecture

We will be following a basic flow:

Create the DynamoDB database where the user details will be stored.
Creating and testing an AWS Lambda function to hold user information.

3.Writing the main Lambda function in python to access the AWS DynamoDB database and access the API body inputs from the post request which will be handled by AWS API gateway.

Part 1: Create the AWS DynamoDB

Preamble: AWS DynamoDB is a nosql database which uses key-value pairs to access and populate table elements. It is flexible and can be used without knowledge of SQL or building schemas.

After you log into your AWS console, type DynamoDB in the search panel and view the option to create a new table.

Once you click the create button option, you can name your table. Provide a name which corresponds to the data you intend to store. In our case, you can use storeUserEmail.
Create a proper partition key. A partition key is a unique identifier for your table content. This is commonly known as the primary key in databases. It is unique and is used to retrieve data from your table. You may use userId as the partition/ primary key.
You may create a sort key but in our case we do not need one as our project requires only a basic database.

Part 2: Creating a lambda function to write to your AWS DynamoDB table

Creating a lambda function:

Navigate to AWS Lambda from the AWS console.
Click the "Create function" button
Select "Author from scratch".
Input a function name.
Select your preferred runtime option. That is, the programming language you will like to run your function on.
For the purpose of this project, you can leave the rest options as default.
Complete the process by clicking "create function" at the bottom of the form and your function would have been successfully created.

Configuring your Lambda function:

From the options right under the function overview, select "code".
Paste the following code:

# import the json utility package since we will be working with a JSON object
import json
# import the AWS SDK (for Python the package name is boto3)
import boto3
# import two packages to help us with dates and date formatting
from time import gmtime, strftime

# create a DynamoDB object using the AWS SDK
dynamodb = boto3.resource('dynamodb')
# use the DynamoDB object to select our table
table = dynamodb.Table('YOUR-DYNAMODB-TABLE-NAME')
# store the current time in a human readable format in a variable
now = strftime("%a, %d %b %Y %H:%M:%S +0000", gmtime())

# define the handler function that the Lambda service will use as an entry point
def lambda_handler(event, context):
# extract values from the event object we got from the Lambda service and store in a variable
    user = event['user']
    email = event['email']
# write name and time to the DynamoDB table using the object we instantiated and save response in a variable
    response = table.put_item(
        Item={
            'user': user,
            'email': email,
            'timestamp': now
            })
# return a properly formatted JSON object
#create message
    message = f'hello {user} your {email} has been successfully added to the waitlist'
    return {
        'statusCode': 200,
        'body': json.dumps(message)
    }

Click "deploy" then select the option to test the function by clicking the arrow beside "Test" button.
Select to "configure a test event".
Select "create a new event" then provide a test event name.
Leave the private option and select an event template.
You can select the HelloWorld template and edit it to meet the key value pairs to be expected in the event handler. Example code below:

{
  "email": "test@example.com",
  "user": "tester"
}

Save and return to the lambda function code.
Click test above the code and you should get a 200 status response.

IMPORTANT NOTE TO CONFIGURE LAMBDA TO WRITE TO DYNAMODB:

Navigate to configuration under your newly created Lambda function. Under configuration click permissions and click the link to the execution role which would redirect you to the IAM service.

Click add permissions and select inline policy

Replace the following code to the policy editor and replace your table ARN with the ARN.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "dynamodb:PutItem",
                "dynamodb:DeleteItem",
                "dynamodb:GetItem",
                "dynamodb:Scan",
                "dynamodb:Query",
                "dynamodb:UpdateItem"
            ],
            "Resource": "YOUR-DYNAMODB-TABLE-ARN"
        }
    ]
}

Part 3: Configure the AWS API gateway to trigger your Lambda function

Navigate to AWS API Gateway on the console and select "create api"
Scroll to "RESTAPI" then click "Build".
Next create new method and enable CORS with default settings.
Configure the API gateway to integrate with Lambda. Create "Post" method from the first method drop down. Select Lambda and click the "lambda function" dropdown to select your preferred Lambda function name. This corresponds to the name of the lambda function you created to this project. Finally, click "create method"
Next, its time to deploy the API. On the top right page, click "deploy API".
Select a stage or create a "New stage". Give a description and click "deploy".
Get the link to the API endpoint by copying the URL under "Invoke URL".

Bonus Stage 3: Test API on Postman

Paste the "Invoke URL" link from API gateway into the URL tab in postman.
Select "Post" and then click "send". You should get a status 200 okay response and the data will be added to your DynamoDB table.

Thank you for reading and I hope this helps you on your journey navigating AWS cloud services. Please drop a comment with suggestions, challenges and feedback.

DEV Community: Bola Olatunji