Example FastAPI tutorial with automated deployment

Step-by-step tutorial: https://blog.karmacomputing.co.uk/fastapi-production-deployment-with-dokku-and-github-actions/

Built upon the amazing documentation at: https://fastapi.tiangolo.com/tutorial/ and thanks to https://github.com/idoberko2/dokku-deploy-github-action

What do I get?

Automated FastAPI deployments from the main branch using Dokku via Github actions
Automated TLS certificates and renewal
Automated OpenAPI docs thanks to FastAPI Demo

How long will it take?

About 30mins

How much will it cost me?

Your time, and about $5p/m if you don't already have a server

How do I run it locally?

Create & activate a python3 virtual environment (optional, but very recommended)

Install requirements:

pip install -r requirements.txt

Manually seed the database (not needed because using create_all in main.py, but useful to know how to access the db without booting the entire app):

python
Python 3.6.8 (default, Apr  9 2019, 04:59:38) 
[GCC 8.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from app import models
>>> from app.database import engine
>>> models.Base.metadata.create_all(bind=engine)
>>> exit()

Verify the database by looking for sql_app.db in your project root directory. Then using sqlite3 to verify the schema e.g.:

sqlite3 sql_app.db
SQLite version 3.24.0 2018-06-04 19:24:41
Enter ".help" for usage hints.
sqlite> .schema
CREATE TABLE users (
	id INTEGER NOT NULL, 
  ...
);
CREATE UNIQUE INDEX ix_users_email ON users (email);
CREATE INDEX ix_users_id ON users (id);
CREATE TABLE items (
	id INTEGER NOT NULL, 
  ...
);
CREATE INDEX ix_items_title ON items (title);
...
sqlite> .q

Manually access the database:

sqlite3 sql_app.db
SQLite version 3.24.0 2018-06-04 19:24:41
Enter ".help" for usage hints.
>>> from app.database import *
>>> db = SessionLocal()
>>> from app.models import User
>>> db.query(User).all()
>>> [] # Empty

Run the app locally:

Set environment variables

cd app
export DB_CONNECTION=sqlite:///./sql_app.db # see https://docs.sqlalchemy.org/en/13/core/engines.html for examples
export SECRET_KEY=changeme # to generate a key use: openssl rand -hex 32

uvicorn main:app --reload

Visit:

http://127.0.0.1:8000

Port already in use? Close the other app, or use a difference port:

uvicorn main:app --port 8001 --reload

Performance

Pointless benchmark: Throwing 10,000's request, with concurrency 10 at the /random endpoint which generates and returns a pseudo random number using python's random function, served by FastAPI.

Instance: Cheap as chips $5 VPS with 1024MB Memory, 1000GB Bandwidth, running ubuntu 18.04 with only 129M of free memory (free -h).

A median of 62ms for processing and waiting seems pretty good. see definitions.