/exchange-rate-api

Exchange Rate API using .NET 5 and AWS infrastructure

Primary LanguageC#

Exchange Rate API

API responsible for making foreign currency quotes for BRL (Brazilian Real).

Instructions for run project

Run project via Docker, via Visual Studio (F5 or CTRL + F5), Visual Studio Code (tasks project) or CLI.

Docker

docker-compose up -d

.NET CLI

  • Run project
src/Exchange.Rate.API

dotnet watch run
  • Run tests
dotnet test -t

Endpoints

GET /quote

curl -X GET "http://localhost:5000/api/v1/exchange-rates/quote?amount=10&currency=USD" -H  "accept: application/json"

GET /conversion

curl -X GET "http://localhost:5000/api/v1/exchange-rates/conversion?amount=10&currency=USD&customerSegment=PRIVATE" -H  "accept: application/json"

For more information visit swagger: http://localhost:5000/swagger/index.html

Deploy

AWS arquitecture reference

https://github.com/thombergs/code-examples/blob/master/aws/cloudformation/ecs-in-two-public-subnets/ecs-in-two-public-subnets.svg

Step by step to manual deploy using AWS CloudFormation:

  1. Create Docker image repository

This project uses the AWS ECR (Docker Container Registry) as a Docker image repository. Other repositories can be used, such as the Docker Hub.

  • Execute docker-compose file:
docker-compose up -d

Enter the folder scripts/aws/ecr and run the scripts:

  • Run script to create AWS ECR:
sh ecr-deploy.sh
  • Run script to deploy the AWS ECR image. Necessary to include AWS AccountId as a parameter:
sh image-deploy.sh 999999999999
  1. Create networks

Enter the folder scripts/aws/networks and run the scripts:

  • Run script to create and deploy networks
sh network-deploy.sh
  1. Create services

Check the status of network creation on AWS CloudFormation. Run this step only when the status is completed: CREATE_COMPLETE.

Enter the folder scripts/aws/services and run the scripts:

  • Run script to create and deploy services. Necessary to include AWS AccountId as a parameter:
sh service-deploy.sh 999999999999

The deployment of this project via AWS CloudFormation was based on the following references:

Delete deploy

aws cloudformation delete-stack \
  --stack-name exchange-rate-api-service

Run delete stack service step only when the status is completed: CREATE_COMPLETE.

aws cloudformation delete-stack \
  --stack-name exchange-rate-api-network