Project Name

MonolithMorph

Description

In this project, I successfully deployed a monolithic Node.js application to a Docker container and then decoupled it into microservices without any downtime. The application is a message board that allows users to interact through threads and messages.

Prerequisites

1. Clone the Repository

   git clone <your-repo-link>
   cd <your-repo-directory>
   

2. AWS Account: Sign up here if you don't have one.

3. Docker: Install for Mac or Windows.

• Confirm installation with:

  docker --version
  

4. AWS CLI:

• Getting Started with AWS CLI.

• Confirm installation:

  aws --version
  

5. AWS Copilot Installation:

• macOS:

  curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot —help
  

• Linux x86 (64-bit):

  curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot —help
  

• Linux (ARM):

  curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux-arm64 && chmod +x copilot && sudo mv copilot
  

• Windows:

  Invoke-WebRequest -OutFile 'C:\Program Files\copilot.exe' https://github.com/aws/copilot-cli/releases/latest/download/copilot-windows.exe
  

Deployment Steps

1. Initialize AWS Copilot Application

   cd ./amazon-ecs-nodejs-microservices/
   copilot app init
   

2. Set Up Environment

   copilot env init
   

3. Deploy the Environment

   copilot env deploy --name api
   

4. Set Up Monolithic AWS Copilot Service

   copilot svc init
   

5. Deploy the Monolithic Service

   copilot svc deploy --name monolith
   

6. Test the Deployment

• Use the provided AWS Copilot URL to test endpoints.

Creating Microservices

1. Initialize the Microservices

   copilot svc init --app api --dockerfile ./3-microservices/services/posts/Dockerfile --name posts --svc-type "Load Balanced Web Service"
   copilot svc init --app api --dockerfile ./3-microservices/services/threads/Dockerfile --name threads --svc-type "Load Balanced Web Service"
   copilot svc init --app api --dockerfile ./3-microservices/services/users/Dockerfile --name users --svc-type "Load Balanced Web Service"
   

2. Configure Service Paths

• AWS Copilot sets the path based on the service name. Edit the manifest.yml for each service to adjust the path.

Deploying Microservices

1. Deploy the Microservices

   copilot svc deploy --name posts
   copilot svc deploy --name threads
   copilot svc deploy --name users
   

2. Shut down the Monolith

   copilot svc delete --name monolith
   

3. Verify the Deployment

• Use the provided URLs to validate the microservices deployment.

Cleanup and Conclusion

1. Delete the Application

   copilot app delete --name api
   

Congratulations! You've now broken a monolithic application into microservices, offering more flexibility and scalability.