AWS Microservices Demo with CDK and Fargate

About

Simple AWS microservice-based app.

Consists of two Spring Boot based services:

• Name Service

  • GET /name/{some_name}
    • Concatenates {some_name} with the last name of a US president
    • Returns { "name": "some_name some_presidents_last_name" }
  • GET /hello/internal/health
    • Health check endpoint for ELB

• Hello World Service

  • GET /hello/{some_name}
    • Uses ELB based service discovery to call name service and says hello to the returned full-name
    • Returns { "hello": "some_name some_presidents_last_name" }
  • GET /hello/internal/health
    • Health check endpoint for ELB

Technology

• AWS
  • ECS/Fargate
  • Elastic Load Balancer
  • CDK (TypeScript)
• Java
  • Spring Boot

Architecture

Requirements

• Java 11
• TypeScript
• Maven
• NPM
• Docker
• AWS CLI
• AWS CDK
• Git Bash or WSL if using Windows

Build

Build docker images:

Navigate to /infrastructure/scripts

Run: bash build-images.sh

Verify Build

Open two new terminals:

Navigate to /infrastructure/scripts/local

Run:

bash run-name-service.sh

bash run-hello-world-service.sh

Open:

http://localhost:8081/hello/nick

You should see a JSON response with the following format:

{"hello":"nick Clinton"}

Deploy

Create ECR Repository on AWS for Images

Run:

aws ecr create-repository --repository-name aws-fargate-demo

Push Images to AWS ECR Repository

Navigate to /infrastructure/scripts

Run:

bash ecr-deploy-sh

• Enter your AWS Credentials and the name of the ECR repository you created
• When prompted for image id, copy the image ID of the repository with name aws-fargate-demo/name-service
• When prompted for image name, type name-service
• Reply y when asked if you want to delete previous images if you would like to avoid extra costs, n otherwise
• Repeat for hello-world-service

Create AWS Infrastructure

Navigate to /infrastructure

Install dependencies: npm install

Deploy infrastructure: cdk deploy

Verify Deploy

Run:

aws elbv2 describe-load-balancers

Copy the DNS name of the created load balancer

Navigate to:

http://DNS_NAME_GOES_HERE/hello/nick

In my case:

http://awsfa-awsfa-wg458r9ycnd8-2128681189.us-east-1.elb.amazonaws.com/hello/nick

You should see a JSON response with the following format:

{"hello":"nick Clinton"}

Cleanup

Delete ECR Repository and Images

aws ecr delete-repository --repository-name aws-fargate-demo --force

Delete infrastructure

cdk destroy