matthewcylau / python-flask-aws-terraform Goto Github PK

View Code? Open in Web Editor NEW

Deploy a Python Flask app onto Amazon ECS on AWS Fargate with Terraform

Dockerfile 1.56% Python 24.68% HCL 68.22% Smarty 4.92% Shell 0.61%

python-flask-aws-terraform's Introduction

AWS Fargate Python Flask App

A reference project to deploy a Python Flask app onto Amazon ECS on AWS Fargate with Terraform. Inspired by this AWS tutorial

A todo app creating, and retrieving data from Amazon RDS

Pre-requisite

Make sure you have installed Python 3, pip, Terraform, AWS CLI, and configured a default AWS CLI profile (see doc here)

terraform -help # prints Terraform options
which aws # prints /usr/local/bin/aws
aws --version # prints aws-cli/2.0.36 Python/3.7.4 Darwin/18.7.0 botocore/2.0.0
aws configure # configure your AWS CLI profile
python3 --version # prints Python 3 version
pip3 --version # prints pip version

Run/Build app locally

In a seperate terminal window, run docker-compose -f docker-compose.dev.yml up to run PostgreSQL database inside a container. Then, return to the original terminal window and run the following commands:

virtualenv -p /usr/bin/python3 venv # create new virtual environment venv
source venv/bin/activate # activate venv
pip3 install -r requirements.txt # installs python packages
python3 manage.py # visit app at http://localhost:5000/ping
deactivate # deactivates venv

Install new packages

pip3 install boto # installs new Python package
pip3 freeze > requirements.txt # updates requirements.txt

Run app in container

Run docker-compose up to start app in container. Alternatively, you may choose to build, and run the api app image:

docker build -t matlau/python-flask-aws:latest . # build Docker image
docker run -p 5000:5000 matlau/python-flask-aws # visit app at http://localhost:5000/ping

Configuration

Create an S3 bucket to store Terraform state. Populate bucket name in 01-main.tf
Create a secret on AWS Secrets Manager named RDSPostgresPassword with key POSTGRES_PASSWORD, and your database password as value
Populate terraform.tfvars:

default_region      = "<YOUR_AWS_DEFAULT_REGION>"
app_name            = "<GIVE_YOUR_APP_A_NAME!>"
environment         = "<ENVIRONMENT_NAME>"

Deploy AWS stack

cd deploy # change to deploy directory
terraform init # initialises Terraform
terraform apply # deploys AWS stack. See output for API url
terraform destroy # destroys AWS stack