Skip to content


Those instructions will deploy the REST API python3 project into AWS according to the following architecture :

AWS Architecture

A highly available and cost effective REST API application deployed using those services :

  • Compute : AWS ECS [FARGATE]
  • Database : AWS RDS [POSTGRES]
  • Load Balancing : AWS ELB [Application Load Balancer]
  • Container Registry : AWS ECR
  • Credential Management : AWS Secret Manager
  • Logging : AWS CloudWatch Logs
  • Monitoring : AWS CloudWatch Dashboard, Metrics
  • Alerting : AWS CloudWatch Alarm, AWS SNS [EMAIL]


Before statring, you must install all dependencies below inside a centos-7 Linux environment

1- Install Terraform v1.0.6

sudo curl -o /tmp/terraform_${TERRAFORM_VERSION}${TERRAFORM_VERSION}/terraform_${TERRAFORM_VERSION}
sudo unzip /tmp/terraform_${TERRAFORM_VERSION} -d /tmp

echo Moving terraform binary to /usr/local/bin/
sudo mv /tmp/terraform /usr/local/bin/
sudo /usr/local/bin/terraform --install-autocomplete > /dev/null 2>&1 || echo autocomplete already installed
2- Create AWS Account

Follow those two steps to create new account, grant permission to new user and download AWS Access key/AWS Secret Access key: * Create aws account * Create aws user and access key pair

3- Install AWS CLI
curl "" -o ""
sudo ./aws/install
4- Configure AWS CLI
aws configure 
AWS Access Key ID [****************Z47Z]:
AWS Secret Access Key [****************Bstj]:
Default region name [eu-west-3]:
Default output format [JSON]:

Deploy Application to AWS

1- Fill terraform.tfvars file
s3_name_prefix      = "hello-world"
rds_username        = "USERNAME"
rds_password        = "PASSWORD"
email               =""
2- Initiate terraform state file
terraform init
3- Create Elastic Container Registry

This registry is user to store REST API docker image built earlier

terraform apply --target=aws_ecr_repository.hello_world
# Type yes

4- Tag and push docker container into the registry
docker tag hello-world:v0.1 [REGISTRY_URL]:latest
docker push [REGISTRY_URL]:latest
5- Deploy the hole application
terraform apply
# Type yes

Acceptance tests

Acceptance tests must be executed on the running application on AWS

1- Create the database table

This instruction must be done using pgAdmin. Grab the RDS endpoint : [RDS_ENDPOINT], then connect to the database.

-- create table

    user_id serial PRIMARY KEY,
    username VARCHAR UNIQUE,
    date_of_birth DATE NOT NULL

2- Tests endpoints

Grab the public DNS of the created Application Load Balancer : [PUBLIC_DNS]

# Test PUT request:
curl -X PUT -H "Content-Type: application/json" \
    -d '{"dateOfBirth":"2012-12-31"}' \ 

# Test GET request :
curl -X 'GET' \
  'http://[PUBLIC_DNS]/hello/jhon' \
  -H 'accept: application/json'


  • Oussama BEN CHARRADA - Initial work