FastAPI Tutorial

This is a simple example FastAPI application that pretends to be a bookstore.

Deploying to AWS EC2

Log into your AWS account and create an EC2 instance (t2.micro), using the latest stable Ubuntu Linux AMI.

SSH into the instance and run these commands to update the software repository and install our dependencies.

sudo apt-get update
sudo apt install -y python3-pip nginx

Clone the FastAPI server app (or create your main.py in Python).

git clone https://github.com/pixegami/fastapi-tutorial.git

Add the FastAPI configuration to NGINX's folder. Create a file called fastapi_nginx (like the one in this repository).

sudo vim /etc/nginx/sites-enabled/fastapi_nginx

And put this config into the file (replace the IP address with your EC2 instance's public IP):

server {
    listen 80;   
    server_name <YOUR_EC2_IP>;    
    location / {        
        proxy_pass http://127.0.0.1:8000;    
    }
}

Start NGINX.

sudo service nginx restart

Start FastAPI.

cd fastapi-tutorial
python3 -m uvicorn main:app

Update EC2 security-group settings for your instance to allow HTTP traffic to port 80.

Now when you visit your public IP of the instance, you should be able to access your API.

We'll need to modify the API so that it has a Lambda handler. Use Mangum:

from mangum import Mangum

app = FastAPI()
handler = Mangum(app)

We'll also need to install the dependencies into a local directory so we can zip it up.

pip install -t lib -r requirements.txt

We now need to zip it up.

(cd lib; zip ../lambda_function.zip -r .)

Now add our FastAPI file and the JSON file.

zip lambda_function.zip -u main.py
zip lambda_function.zip -u books.json