NOTE: This is not an officially supported Google product
Introduction
This project is used by the Google Cloud Platform team to demonstrate different services within Google Cloud. This project contains two versions of the same application, one architected as a monolith and the other as a set of microservices.
Setup
git clone https://github.com/googlecodelabs/monolith-to-microservices
cd monolith-to-microservices
./setup.sh
Monolith
To run the monolith project use the following commands from the top level directory:
cd monolith
npm start
You should see output similar to the following:
Monolith listening on port 8080!
That's it! You now have a perfectly functioning monolith running on your machine!
Docker
To create a Docker image for the monolith, execute the following commands:
cd monolith
docker build -t monolith:1.0.0 .
To run the Docker image, execute the following commands:
docker run --rm -p 8080:8080 monolith:1.0.0
Microservices
To run the microservices project use the following commands from the top level directory:
cd microservices
npm start
You should see output similar to the following:
[0] Frontend microservice listening on port 8080!
[2] Orders microservice listening on port 8081!
[1] Products microservice listening on port 8082!
That's it! You now have a perfectly functioning set of microservices running on your machine!
Docker
To create a Docker image for the mmicroservices, you will have to create a Docker image for each service. Execute the following commands for each folder under the microservices folder.
cd microservices/src/frontend
docker build -t frontend:1.0.0 .
cd ../products
docker build -t products:1.0.0 .
cd ../orders
docker build -t orders:1.0.0 .
To run the Docker image, execute the following commands:
docker run -d --rm -p 8080:8080 monolith:1.0.0
docker run -d --rm -p 8081:8081 orders:1.0.0
docker run -d --rm -p 8082:8082 products:1.0.0
To stop the containers, you will need to find the CONTAINER ID for each and stop them individually. See the steps below:
docker ps -a
CONTAINER ID IMAGE COMMAND CREATED
4c01db0b339c frontend:1.0.0 bash 17 seconds ago
d7886598dbe2 orders:1.0.0 bash 17 seconds ago
d85756f57265 products:1.0.0 bash 17 seconds ago
docker stop 4c01db0b339c
docker stop d7886598dbe2
docker stop d85756f57265
React App
The react-app folder contains a React application created from create-react-app. You can modify this fronted, but afterwards, you will need to build and move the static files to the monolith and microservices project. You can do this by running the standard create-react-app build command below:
npm run build
This will run the build script to create the static files two times. The first will build with relative URLs and copy the static files to the monolith/public folder. The second run will build with the standard microservices URLs and copy the static files to the microservices/src/frontned/public folder.