/aws-terraform-demo

Primary LanguageHCL

freeup

What this code does

  1. Create a highly-available Serverless architecture on AWS using Terraform. The architecture consists of:
  • Cloudfront
  • API Gateway
  • Lambda
  • RDS (MySQL)
  1. Create a Lambda function in JavaScript and host it on the above infrastructure. The function returns a simple message in JSON and a 200 HTTP status code.

Architecture

Jodi AWS network diagram

Once the database is created, the database schema is set up using a second lambda function:

database schema lambda

Steps to use this

  1. Make sure you have access to AWS via your Access Key ID and Secret Access Key.
  2. Go to the staging folder and do terraform init and then terraform apply.
  3. At the end of the terraform apply it will output the CloudFront domain name. Use this domain name to access the API as decribed below.

API Documentation

Endpoint HTTP Method Result
/helloworld any Returns "Hello World"
/message POST Adds a message to the message table in the database
/message anything except POST Returns messages in database
anything else any Returns 404 not found error

Points to note

The Cloud Front distribution is set up to cache the response to GET requests, so if you do GET /message, then POST /message, then GET /message again, the response will not contain the new message unless the TTL has expired.

Things that are missing that should be added

  1. Allowing more than 2 AZs
  2. Tests
  3. Better descriptions of variables
  4. More consistent naming
  5. Readme for each module